#include "l_bitmap.h"
L_LTANN_API L_INT L_AnnCopy(hSource, phDest)
HANNOBJECT hSource; |
/* handle to the annotation object to be copied */ |
pHANNOBJECT phDest; |
/* address of the HANNOBJECT variable to be updated */ |
Makes a copy of an annotation object.
Parameter |
Description |
hSource |
Handle to the annotation object to be copied. |
phDest |
Address of the HANNOBJECT variable to be updated with the handle of the new annotation object. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes |
Comments
(Document and Medical) Before calling this function, you must declare a variable of data type HANNOBJECT. Then, pass the address of the variable in the phDest parameter. This function will update the variable with the handle of the annotation object created by the copy.
Required DLLs and Libraries
LTANN For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Win32, x64.
See Also
Functions: |
L_AnnCopyFromClipboard, L_AnnCopyToClipboard, L_AnnCutToClipboard, L_AnnClipboardReady |
Topics: |
Annotation Functions: Creating and Deleting Annotations |
|
Example
This example copies an object and moves the copy so that it can be seen.
L_INT AnnCopyExample(HANNOBJECT hContainer, HANNOBJECT hAnnObject) { L_INT nRet; HANNOBJECT NewObject; /* New object created by copying */ ANNRECT ContainerRect; /* Rectangle for positioning the new object */ /* Copy the incoming object and insert it into the container */ nRet = L_AnnCopy(hAnnObject, &NewObject); if(nRet != SUCCESS) return nRet; nRet = L_AnnInsert(hContainer, NewObject, FALSE); if(nRet != SUCCESS) return nRet; /* Move the new object down and to the right */ nRet = L_AnnGetRect(hContainer, &ContainerRect, NULL); if(nRet != SUCCESS) return nRet; nRet = L_AnnMove(NewObject, (ContainerRect.right - ContainerRect.left) / 20, (ContainerRect.bottom - ContainerRect.top) / 20, 0); if(nRet != SUCCESS) return nRet; return SUCCESS; }