References ▼
#include "lvkrn.h"
L_LVKRN_API L_INT L_VecCopyFromClipboard(hWnd, pVector, dwFlags)
L_HWND hWnd; |
handle to the active window |
pVECTORHANDLE pVector; |
pointer to a vector handle |
L_UINT32 dwFlags; |
copy flags |
Copies vector data from the clipboard to the specified vector handle. This function is available in the LEADTOOLS Vector Imaging Pro Toolkit.
| Parameter | Description | |
| hWnd | Handle to the active window. | |
| pVector | Pointer to the vector handle to be updated with the vector data from the clipboard. This function will allocate the storage to hold the new vector image. | |
| dwFlags | Flag that indicates the behavior of the copy process. Possible values are: | |
| Value | Meaning | |
| 0 | Copy the entire vector handle from the source vector to the destination vector. | |
| VECTOR_FLAGS_SELECTED_ONLY | Copy only selected objects from the source vector to the destination vector. | |
| VECTOR_FLAGS_REPLACE | Empty the destination vector before copying. | |
| VECTOR_FLAGS_RENAME_DUPLICATES | Renames duplicate layer names if found. This flag is only valid when VECTOR_FLAGS_REPLACE is not specified. The toolkit will add a suffix (0, 1, 2, etc) to the layer name if duplicated. Checking will be aborted when the suffix value reaches 999 and no unique name can be created. | |
| VECTOR_FLAGS_COPY_INTO_ACTIVE_LAYER | Copies objects and layers into the active layer of the destination vector. | |
| VECTOR_FLAGS_COPY_LAYERS_ONLY | Copies all layers and objects from the source vector to the destination vector. Transformation, camera, viewport and all other properties of the destination vector will not be effected. | |
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
This function will not remove the vector data from the clipboard.
To determine whether valid vector data is on the clipboard, call L_VecClipboardReady.
To copy vector data to the clipboard from a vector handle, call L_VecCopyToClipboard.
Required DLLs and Libraries
LVKRN For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Functions: |
|
Topics: |
This example loads a vector using clipboard data, if available.
L_INT VecCopyFromClipboardExample(HWND hWnd,pVECTORHANDLE pVector){L_INT nRet = FAILURE;if( L_VecClipboardReady() )/* Copy the vector image from the clipboard */nRet = L_VecCopyFromClipboard( hWnd, pVector, VECTOR_FLAGS_REPLACE );return nRet;}