CONTAINERCALLBACK

#include "LtCon.h"

L_INT pEXT_CALLBACK YourFunction(pContainer, nEventType, pEventData, pUserData)

pCONTAINERHANDLE pContainer;

/* pointer to a container handle */

CONTAINEREVENTTYPE nEventType;

/* container event type */

L_VOID * pEventData;

/* pointer to event specific data */

L_VOID * pUserData;

/* pointer to additional parameters */

Handles each event that occurs in the container.

Parameter

Description

pContainer

Pointer to a container handle.

nEventType

The type of the event sent by the container. Possible values are:

 

Value

Meaning

 

CONTAINER_EVENT_TYPE_DRAW

The container is now drawing.

pEventData

Pointer to a structure that contains data associated with the event specified in nEventType. When nEventType is CONTAINER_EVENT_TYPE_DRAW, then the pEventData must be type pCONTAINEROBJECTDATA.

 

Keep in mind that this is a void pointer, which must be cast to the appropriate data type for the event data.

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 the calling function.)

 

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.

Required DLLs and Libraries

LTCON

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_ContainerSetCallback, L_ContainerGetCallback.

Example

For an example, refer to L_ContainerSetCallBack.