References ▼
This callback is called every time the user creates, changes or removes a region from one of the bitmaps displayed in a cell.
#include "ltivw.h"
L_INT pEXT_CALLBACK YourFunction(hCellWnd, hRgn, nCellIndex, nSubCellIndex, uOperation, pUserData)
A handle to the window that represents the Medical Viewer Cell.
Handle to the Windows region.
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 of the sub-cell. This sub-cell contains the image that contains the region changed. Pass -2 to refer to the selected sub-cell.
The action to take regarding the existing bitmap region, if one is defined. It can be one of the following value:
| Value | Meaning |
|---|---|
| L_RGN_AND | [0] An AND operation has been applied to the existing region. |
| L_RGN_SET | [1] A new region has been created. |
| L_RGN_ANDNOTRGN | [3] The existing region has been reduced. |
| L_RGN_OR | [4] A new region has been combined with the existing one. |
| L_RGN_SETNOT | [6] An inverted region has been created. |
| L_RGN_REMOVE | [8] The existing region has been removed. |
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_DispContainerSetRegionCallBack.) 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 get the region callback, use L_DispContainerGetRegionCallBack. To set the region callback, use L_DispContainerSetRegionCallBack.
For an example, refer to L_DispContainerGetRegionCallBack.