In This Topic ▼

L_AnnCreateContainer

Summary

Creates and initializes an annotation object that is a container.

Syntax

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnCreateContainer(hWnd, pRect, fVisible, phObject)

Parameters

HWND hWnd

Handle to the window for the container.

pANNRECT pRect

Pointer to the LEADTOOLS ANNRECT structure that specifies the container. The ANNRECT structure is like a Windows RECT structure, except that it uses double-precision floating point values.

Coordinates of an object's rectangle are relative to its container object. The coordinates are interpreted using the container's scaling factors and offsets, which are described in Low-Level Coordinate System for Annotations.

L_BOOL fVisible

Flag that indicates whether the container will be visible. Possible values are:

Value	Meaning
TRUE	The container is visible.
FALSE	The container is not visible.

pHANNOBJECT phObject

Address of the variable to be updated with the handle to the 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 phObject parameter. This function will update the variable with the handle of the new annotation object.