DISPCONTAINERTAGCALLBACK Callback Function

#include "ltivw.h"

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

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

This callback function is called before the window control paints a cell that contains an owner draw tag. This function is available only in the Medical Imaging Suite toolkits.

Parameter	Description
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.

Functions:	L_DispContainerSetTagCallBack, L_DispContainerGetTagCallBack, L_DispContainerSetActionCallBack, L_DispContainerGetActionCallBack, DISPCONTAINERACTIONCALLBACK
Topics:	Image Viewer Cells
	Image Viewer Functions: Image Viewer Cells