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 * 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

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.