LVectorBase::CopyFromClipboard

Summary

Copies vector data from the clipboard to the specified vector handle. This function is available in the LEADTOOLS Vector Imaging Toolkit.

Syntax

#include "ltwrappr.h"

virtual L_INT LVectorBase::CopyFromClipboard(hWnd=NULL, dwFlags=0)

Parameters

HWND hWnd

Handle to the active window.

L_UINT32 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

Value Meaning
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

See Also

Functions

Topics

Example

This example copies a vector image from the clipboard.

L_INT LVectorBase__CopyFromClipboardExample(HWND hWnd, LVectorBase *pVector) 
{ 
   UNREFERENCED_PARAMETER(hWnd); 
 
   L_INT       nRet; 
 
   if (pVector->IsClipboardReady()) 
   { 
      RECT rect; 
 
      nRet = pVector->CopyFromClipboard(hWnd, 0); 
      if(nRet != SUCCESS) 
         return nRet; 
 
      GetClientRect(hWnd, &rect); 
 
      nRet = pVector->SetViewport(&rect); 
      if(nRet != SUCCESS) 
         return nRet; 
 
      nRet = pVector->AttachToWindow(hWnd); 
      if(nRet != SUCCESS) 
         return nRet; 
   } 
 
   return SUCCESS; 
} 

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Vector C++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.