In This Topic ▼

L_AnnCopy

Summary

Makes a copy of an annotation object.

Syntax

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnCopy(hSource, phDest)

Parameters

HANNOBJECT hSource

Handle to the annotation object to be copied.

pHANNOBJECT phDest

Address of the HANNOBJECT variable to be updated with the handle of the new annotation object.

Returns

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

Platforms

Win32, x64.

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, L_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; 
 
   return L_AnnMove(NewObject, 
      (ContainerRect.right - ContainerRect.left) / 20, 
      (ContainerRect.bottom - ContainerRect.top) / 20, 
      0); 
}