DISPCONTAINERACTIVESUBCELLCHANGED

#include "l_bitmap.h"

L_INT pEXT_CALLBACK YourFunction(nCellIndex, nSubCellIndex, nPreviousSubCellIndex, pUserData)

L_INT nCellIndex;

/* index of the cell */

L_INT nSubCellIndex;

/* index of the sub-cell */

L_INT nPreviousSubCellIndex;

/* index into the image list attached to the cell */

L_VOID * pUserData;

/* previous index into the image list */

This callback function is called every time the user changes the active sub-cell.

Parameter

Description

nCellIndex

A zero-based index of the cell, that contains the sub-cell that been changed.

nSubCellIndex

A zero-based index of the new active sub-cell.

nPreviousSubCellIndex

A zero-based index of the sub-cell that was active before changing the active sub-cell index.

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_DispContainerSetActiveSubCellChangedCallBack.) 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 happens when the sub-cell is changed, which occurs by:

1.

Clicking on another sub-cell rect.

2.

Scrolling the cell scroll.

To set the active sub-cell changed callback use L_DispContainerSetActiveSubCellChangedCallBack. To get the active sub-cell changed callback use L_DispContainerGetActiveSubCellChangedCallBack.

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_DispContainerSetRegionCallBack, L_DispContainerGetRegionCallBack, L_DispContainerSetMouseCallBack, L_DispContainerSetActionCallBack, L_DispContainerSetTagCallBack, L_DispContainerGetTagCallBack, L_DispContainerSetAnnotationCallBack, L_DispContainerGetAnnotationCallBack, L_DispContainerGetAnnotationCreatedCallBack, L_DispContainerSetAnnotationCreatedCallBack, L_DispContainerSetPrePaintCallBack, L_DispContainerGetPrePaintCallBack, DISPCONTAINERPREPAINTCALLBACK, L_DispContainerGetPostPaintCallBack, L_DispContainerSetPostPaintCallBack, DISPCONTAINERPOSTPAINTCALLBACK, DISPCONTAINERANNOTATIONCALLBACK, DISPCONTAINERANNOTATIONCREATEDCALLBACK, DISPCONTAINERTAGCALLBACK, DISPCONTAINERACTIONCALLBACK

Topics:

Image Viewer Cells

 

Image Viewer Functions: Callbacks

 

Image Viewer Functions: Image Viewer Cells

Example

For an example, refer to L_DispContainerGetActiveSubCellChangedCallBack.