References ▼
This callback occurs when creating a new annotation object. This function is available only in the Medical Imaging Suite toolkit.
#include "ltivw.h"
L_INT pEXT_CALLBACK YourFunction(nCellIndex, nSubCellIndex, uAnnotationType, pUserData)
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.
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.
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. |
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.
| Value | Meaning |
|---|---|
| SUCCESS | The function was successful. |
| < 1 | An error occurred. Refer to Return Codes. |
To set the annotation-created callback, use L_DispContainerSetAnnotationCreatedCallBack. To get the annotation-created callback, use L_DispContainerGetAnnotationCreatedCallBack.
For an example, refer to L_DispContainerGetAnnotationContainer.