DISPCONTAINERPAINTCALLBACK Callback Function

#include "ltivw.h"

L_INT pEXT_CALLBACK YourFunction(hMemDC, lpRect, nCellIndex, nSubCellIndex, pUserData)

HDC hMemDC;	/* handle to DC */
LPRECT lpRect;	/* pointer to rectangle */
L_INT nCellIndex;	/* index of the cell */
L_INT nSubCellIndex;	/* index of the sub-cell */
L_VOID * pUserData;	/* user data */

This callback function is called during the cell painting.

Parameter	Description
hMemDC	Handle to memory device context is used to paint the cell.
lpRect	Pointer to a RECT structure that contains the client coordinates of the rectangle for the user to paint in.
nCellIndex	A zero-based index of the cell in which the callback will paint.
nSubCellIndex	A zero-based index into the image list attached to the cell specified in nCellIndex. This image is the one on which the callback will paint.
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_DispContainerSetPaintCallBack.) 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

This callback function is called after painting everything in the cell (image, tags, rulers, annotations and region), so if user paints anything, it will be drawn as the top most.

To get the current callback function used to paint the cell, call the L_DispContainerGetPaintCallBack function.
To set the callback function for painting the cell, call the L_DispContainerSetPaintCallBack function.

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_DispContainerGetPaintCallBack, L_DispContainerRepaintCell, L_DispContainerSetPaintCallBack.
Topics:	Image Viewer Cells
	Image Viewer Functions: Image Viewer Cells
	Image Viewer Functions: Callbacks

Example

For an example, refer to L_DispContainerGetPaintCallBack.