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.

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