#include "ltivw.h"
L_LTIVW_API L_INT L_DispContainerSetActionCallBack(hCellWnd, pfnCallBack, pUserData)
L_HWND hCellWnd; |
handle to the cell window |
DISPCONTAINERACTIONCALLBACK pfnCallBack; |
callback function. |
L_VOID * pUserData; |
pointer to more parameters for the callback. |
Sets a callback function, which lets the user handle user-defined actions.
Parameter |
Description |
hCellWnd |
A handle to the window that represents the Medical Viewer Cell. |
pfnCallBack |
Callback function that is called every time the container indicates there has been a mouse or keyboard event that is associated with a user-defined action. |
|
The callback function must adhere to the function prototype described in DISPCONTAINERACTIONCALLBACK. |
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 *. 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. |
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
To get the current callback function used to handle custom actions, call L_DispContainerGetActionCallBack.
The following messages indicate there has been a mouse or keyboard event:
WM_MOUSEMOVE.
WM_LBUTTONDOWN.
WM_RBUTTONDOWN.
WM_MBUTTONDOWN.
WM_XBUTTONDOWN.
WM_LBUTTONUP.
WM_RBUTTONUP.
WM_MBUTTONUP.
WM_XBUTTONUP.
WM_MOUSEWHEEL.
WM_KEYDOWN.
WM_KEYUP.
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_DispContainerGetTagCallBack, L_DispContainerSetTagCallBack, L_DispContainerGetActionCallBack, DISPCONTAINERTAGCALLBACK, DISPCONTAINERACTIONCALLBACK |
Topics: |
|
|
For an example, refer to L_DispContainerGetActionCallBack.