L_AnnGetTextLen

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnGetTextLen(hObject, puLen)

HANNOBJECT hObject;

/* handle to the annotation object */

L_SIZE_T *puLen;

/* address of the variable to be updated */

Gets the length of the specified annotation object's text (character string).

This function is available in the Document and Medical Imaging toolkits.

Parameter

Description

hObject

Handle to the annotation object.

puLen

Address of the variable to be updated with the length of the object's character string.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Before calling this function, you must declare a variable of data type L_UINT. Then, pass the address of the variable in the puLen parameter. This function will update the variable with the length of the annotation object's text.

When hObject is of type ANNOBJECT_RTF, *puLen is updated with the length of the object's unformatted text. To get the length of the formatted text, see L_AnnGetTextRTF.

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 2000 / XP/Vista.

See Also

Functions:

L_AnnSetText, L_AnnGetText, L_AnnGetAutoText, L_AnnGetAutoTextLen, L_AnnSetAutoText

Topics:

Annotation Functions: Object Properties

 

Implementing an Automated Annotation Program

 

Implementing a Non-automated Annotation Program

 

Obtaining Annotation Object Information

Example

For an example, refer to L_AnnGetText.