L_VecCopyFromClipboard

#include "lvkrn.h"

L_LVKRN_API L_INT L_VecCopyFromClipboard(hWnd, pVector, dwFlags)

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.

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 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.

See Also

Functions:

L_VecClipboardReady, L_VecCopyToClipboard.

Topics:

Using the Clipboard

Example

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;
}