L_AnnCopyToClipboard

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnCopyToClipboard(hObject, uFormat, fSelected, fEmpty, fCheckMenu)

Copies the specified annotation objects to the Windows clipboard in either the native format or WMF format.

Parameters

HANNOBJECT hObject

Handle to the annotation object.

L_UINT uFormat

Format for the annotation data. Possible values are:

Value Meaning
ANNFMT_EMF Use the Windows EMF format.
ANNFMT_WMF Use the Windows WMF format.
ANNFMT_XML Use the XML text format. This is LEADs new text-based format which is upward-compatible.

L_BOOL fSelected

Flag that indicates whether to copy all selected objects, or just the specified object. Possible values are:

Value Meaning
TRUE Copy all objects that have the selected property set to TRUE. For getting and setting the selected property, use the L_AnnGetSelected and L_AnnSetSelected functions.
FALSE Copy only the specified object.

L_BOOL fEmpty

Flag that indicates whether to empty the clipboard prior to copying the annotation data to it. Possible values are:

Value Meaning
TRUE Empty the clipboard before copying data to it.
FALSE Add to the existing data on the clipboard.

L_BOOL fCheckMenu

Flag that indicates whether check the automation menu to see if ANNAUTOTEXT_MENU_COPY has been checked. Possible values are:

Value Meaning
TRUE Check the automation menu to see if ANNAUTOTEXT_MENU_COPY has been checked for the specified object. Only those objects with ANNAUTOTEXT_MENU_COPY checked will be copied.
FALSE Do not check the automation menu to see if ANNAUTOTEXT_MENU_COPY has been checked for the specified object. The copied objects are determined by fSelected only.

Returns

Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.

Comments

(Document and Medical) Use the WMF format only for copying for use in another application.

To retain scaling and positioning information, this function always copies the root container, along with the specified object or selected objects. Use the hObject and fSelected parameters as follows:

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

This example copies all annotations to the clipboard.

L_INT AnnCopyToClipboardExample(HANNOBJECT hAnnObject) 
{ 
   HANNOBJECT  TopContainer; /* Root container */ 
   L_INT         nRet; 
 
   /* Get the root container */ 
   L_AnnGetTopContainer(hAnnObject, &TopContainer); 
   /* Copy all annotations to the clipboard */ 
   nRet = L_AnnCopyToClipboard(TopContainer, ANNFMT_XML, FALSE, TRUE, FALSE); 
   if (nRet == SUCCESS) 
      MessageBox(NULL, TEXT("Annotations copied."), TEXT("Notice"), MB_OK); 
   else 
      return nRet; 
   return SUCCESS; 
} 

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

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.