LVectorBase::CopyFromClipboard
#include "ltwrappr.h"
virtual L_INT LVectorBase::CopyFromClipboard(hWnd=NULL, dwFlags=0)
HWND hWnd; |
/* handle to the active window */ |
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. |
|
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 |
Rename 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. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function will not remove the vector data from the clipboard.
To determine whether valid vector data is on the clipboard, call LVectorBase::IsClipboardReady.
To copy vector data to the clipboard from a vector handle, call LVectorBase::CopyToClipboard.
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. |
See Also
Functions: |
LVectorBase::IsClipboardReady, LVectorBase::CopyToClipboard. |
Topics: |
Example
//This example copies a vector image from the clipboard.
L_VOID Example67(HWND hWnd, LVectorBase *pVector)
{
if (pVector->IsClipboardReady())
{
L_INT nRet;
RECT rect;
nRet = pVector->CopyFromClipboard(hWnd, 0);
GetClientRect(hWnd, &rect);
pVector->SetViewport(&rect);
nRet = pVector->AttachToWindow(hWnd);
}
}