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