L_DispContainerSetTagCallBack
#include "ltivw.h"
L_INT EXT_FUNCTION L_DispContainerSetTagCallBack(hCon, pfnCallBack, pUserData);
HDISPCONTAINER hCon; |
/* handle to the container */ |
DISPCONTAINERTAGCALLBACK pfnCallBack; |
/* callback function */ |
/* pointer to more parameters for the callback */ |
Sets a callback function, which lets the user provide and draw custom tags. This function is available only in the Medical Imaging Suite toolkits.
Parameter |
Description |
hCon |
Handle to the container. |
pfnCallBack |
Callback function, which will be called every time the cell, needs to be repainted if the cell contains a custom (ownder draw) tag. |
|
The callback function must adhere to the function prototype described in DISPCONTAINERTAGCALLBACK. |
pUserData |
Void pointer that you can use to pass one or more additional parameters that the callback function needs. |
|
To use this feature, assign a value to a variable or create a structure that contains as many fields as you need. Then, in this parameter, pass the address of the variable or structure, casting it to L_VOID L_FAR *. The callback function, which receives the address in its own pUserData parameter, can cast it to a pointer of the appropriate data type to access your variable or structure. |
|
If the additional parameters are not needed, you can pass NULL in this parameter. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
To get the current tag callback function, call L_DispContainerGetTagCallBack.
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_DispContainerGetTagCallBack, L_DispContainerGetActionCallBack, L_DispContainerSetActionCallBack, DISPCONTAINERTAGCALLBACK, DISPCONTAINERACTIONCALLBACK |
Topics: |
|
|
Example
For an example, refer to L_DispContainerGetActionCallBack.