L_AnnRemove
#include "l_bitmap.h"
L_INT EXT_FUNCTION L_AnnRemove(hObject)
HANNOBJECT hObject; |
/* handle to the annotation object */ |
Removes the specified annotation object from its current container, leaving the object with no container. This function is available in the Document/Medical Toolkits.
Parameter |
Description |
hObject |
Handle to the annotation object. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
If you want the object to be inserted into another container, such as the main container of the display, you must use the L_AnnInsert function.
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
Windows 95 / 98 / Me, Windows 2000 / XP.
See Also
Example
/* This example removes an object from its container and inserts it into the root container */
void TestAnnRemove(HANNOBJECT hAnnObject)
{
HANNOBJECT RootContainer; /* Root container */
/* Get the root container */
L_AnnGetTopContainer(hAnnObject, &RootContainer);
/* Remove the object from its current container */
L_AnnRemove(hAnnObject);
/* Insert the object into the root container */
L_AnnInsert(RootContainer, hAnnObject, FALSE);
return;
}