L_AnnInsert
#include "l_bitmap.h"
L_INT EXT_FUNCTION L_AnnInsert(hContainer, hObject, fStripContainer)
HANNOBJECT hContainer; |
/* handle to the container object */ |
HANNOBJECT hObject; |
/* handle to the annotation object to insert */ |
L_BOOL fStripContainer; |
/* flag that indicates whether to insert a container */ |
Inserts the specified annotation object into the specified container. This function is available in the Document/Medical Toolkits.
Parameter |
Description |
|
hContainer |
Handle to the container object, a specialized annotation object. |
|
hObject |
Handle to the annotation object to insert. |
|
fStripContainer |
Flag that indicates whether to insert a container. Possible values are: |
|
|
Value |
Meaning |
|
TRUE |
If the hObject parameter specifies a container, only the objects in the container will be inserted into the new container. In this case, the container specified in hObject is destroyed. |
|
FALSE |
If the hObject parameter specifies a container, the container and all objects within the container (objects and other containers ) will be inserted into the new container. |
|
|
If the hObject parameter specifies an object, that object will be inserted into the new container. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
If hObject is a single annotation object, set fStripContainer to FALSE. That way the object itself is inserted.
If hObject is a container, setting fStripContainer to TRUE will insert only the objects within the container, not the container itself.
If hObject is a container, setting fStripContainer to FALSE will insert the container and all objects within the container.
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
For an example ,refer to L_AnnCreate.