L_AnnInsert

Summary

Inserts the specified annotation object into the specified container.

Syntax

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnInsert(hContainer, hObject, fStripContainer)

Parameters

HANNOBJECT hContainer

Handle to the container object, a specialized annotation object.

HANNOBJECT hObject

Handle to the annotation object to insert.

L_BOOL 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

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

Platforms

Win32, x64.

See Also

Functions

Topics

Example

For an example, refer to L_AnnCreate.

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

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