DISPCONTAINERTAGCALLBACK Callback Function

#include "ltivw.h"

L_INT pEXT_CALLBACK YourFunction(hCellWnd, nCellIndex, hDC, lpRect, pUserData)

HWND hCellWnd;	/* handle to the cell window */
L_INT nCellIndex;	/* index of the cell that called the callback */
HDC hDC;	/* memory DC for painting */
RECT * lpRect;	/* pointer to a structure */
L_VOID * pUserData;	/* user data */

This callback function is called before the window control paints a cell that contains an owner draw tag.

Parameter	Description
nCellIndex	A handle to the window that represents the Medical Viewer Cell.
nCellIndex	Index of the cell, which has the owner draw tag.
hDC	Memory DC that is used to paint the cell.
lpRect	Pointer to a RECT structure that contains the area of the owner draw tag in the Memory DC.
pUserData	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_DispContainerSetTagCallBack.) Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

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

Comments

When the window control paints a cell that contains an "owner draw" tag, this callback function is called to allow the user to draw a custom tag. This callback function is only called however, if it has been set by calling L_DispContainerSetTagCallback.

To get the current callback function used to draw custom tags, 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_DispContainerSetTagCallBack, L_DispContainerGetTagCallBack, L_DispContainerSetActionCallBack, L_DispContainerGetActionCallBack, DISPCONTAINERACTIONCALLBACK
Topics:	Image Viewer Cells
	Image Viewer Functions: Callbacks
	Image Viewer Functions: Image Viewer Cells

Example

For an example, refer to L_DispContainerCreate.