In This Topic ▼

L_DispContainerSetActiveSubCellChangedCallBack

Summary

Sets a callback function that is called every time the user changes the active sub-cell.

Syntax

#include "ltivw.h"

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerSetActiveSubCellChangedCallBack (hCellWnd, pfnCallBack, pUserData)

Parameters

L_HWND hCellWnd

A handle to the window that represents the Medical Viewer Cell.

DISPCONTAINERACTIVESUBCELLCHANGED pfnCallBack

Callback function that is called every time the active sub-cell changes, either by clicking on a different sub-cell or by scrolling.

The callback function must adhere to the function prototype described in DISPCONTAINERACTIVESUBCELLCHANGED.

L_VOID * pUserData

Void pointer that you can use to pass one or more additional parameters used by the callback function.

To use this feature, assign a value to a variable or create a structure that contains as many fields as you need. Then 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 additional parameters are not needed, pass NULL.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function sets the active sub-cell for the changed callback. To get the active sub-cell for the changed callback use the L_DispContainerGetActiveSubCellChangedCallBack.