DISPCONTAINERANNOTATIONCREATEDCALLBACK

#include "l_bitmap.h"

L_INT pEXT_CALLBACK YourFunction(nCellIndex, nSubCellIndex, uAnnotationType, pUserData)

L_INT nCellIndex;

/* index of the cell */

L_INT nSubCellIndex;

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

L_UINT uAnnotationType;

/* annotation type */

L_VOID * pUserData;

/* pointer to more parameters for the callback */

This callback occurs when creating a new annotation object. This function is available only in the Medical Imaging Suite toolkit.

Parameter

Description

nCellIndex

A zero-based index of the cell that contains the tag to be deleted. Pass -2 to delete the tag of the specific information in all selected cells in the container.

nSubCellIndex

A zero-based index into the image list attached to the cell specified in nCellIndex. This sub-cell contains the image that contains the tag. Pass -2 to refer to the selected sub-cell.

uAnnotationType

Flag that determines the type of the currently selected annotation object. Possible values are:

 

Value

Meaning

 

ANNOBJECT_TEXT

[15] Text annotation object.

 

ANNOBJECT_RECT

[12] Rectangle annotation object.

 

ANNOBJECT_ELLIPSE

[4] Ellipse annotation object.

 

ANNOBJECT_HILITE

[6] Highlight annotation object

 

ANNOBJECT_PROTRACTOR

[20] Protractor annotation object.

 

ANNOBJECT_RULER

[17] Ruler annotation object.

pUserData

A void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of L_DispContainerSetAnnotationCreatedCallBack.) Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

To set the annotation-created callback, use L_DispContainerSetAnnotationCreatedCallBack. To get the annotation-created callback, use L_DispContainerGetAnnotationCreatedCallBack.

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_DispContainerSetAnnotationContainer, L_DispContainerAnnToRgn, L_DispContainerGetSelectedAnnotationAttributes, L_DispContainerSetAnnotationCallBack, L_DispContainerGetAnnotationCallBack, L_DispContainerGetAnnotationContainer, L_DispContainerSetAnnotationCreatedCallBack, L_DispContainerGetAnnotationCreatedCallBack, DISPCONTAINERANNOTATIONCALLBACK

Topics:

Image Viewer Cells

 

Image Viewer Functions: Callbacks

 

Image Viewer Functions: Image Viewer Cells

Example

XXX