L_DispContainerGetSelectedAnnotationAttributes

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerGetSelectedAnnotationAttributes(hCon, nCellIndex, nSubCellIndex, pAnnAttributes,uFlags)

HDISPCONTAINER hCon;

/* handle to the container */

L_INT nCellIndex;

/* index of a cell */

L_INT nSubCellIndex;

/* index into the image list attached to the cell */

pDISPCONTAINERANNATTRIBS pAnnAttributes;

/* pointer to structure */

L_UINT uFlags;

/* reserved for future use */

Retrieves the attributes of the selected annotation object of the specified sub-cell, if any.

Parameter

Description

hCon

Handle to the container.

nCellIndex

A zero-based index of the cell that holds the sub-cell that contains the selected annotation object.

nSubCellIndex

A zero-based index into the image list attached to the cell specified in nCellIndex. This image contains the annotation object the user wants to retrieve its attributes. Pass -2 to retrieve the selected annotation attributes of the selected sub-cell.

pAnnAttributes

Pointer to a DISPCONTAINERANNATTRIBS structure to be updated with the selected annotation attributes.

uFlags

Reserved for future use. Pass 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function returns ERROR_INV_PARAMTER if there is no selected annotation in the specific sub-cell.

Required DLLs and Libraries

LTIVW

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_DispContainerCreate, L_DispContainerDestroy, L_DispContainerSetAction, L_DispContainerAddAction, L_DispContainerAnnToRgn.

Topics:

Working with Annotations

Image Viewer Functions: Working with Annotations

Example

For an example, refer to L_DispContainerAnnToRgn