DISPCONTAINERANIMATIONSTARTEDCALLBACK

#include "l_bitmap.h"

L_INT pEXT_CALLBACK YourFuction(nCellIndex, pAnimationStartedUserData)

L_INT nCellIndex;	/* index of a cell */
L_VOID * pAnimationStartedUserData;	/* user data */

This callback function is fired if the control animation has been started. This feature is available in version 16 or higher.

Parameter	Description
nCellIndex	Index of the cell, which has the animation engine started.
pAnimationStartedUserData	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_DispContainerSetAnimationStartedCallBack.) 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

To set the current animation started callback function call L_DispContainerSetAnimationStartedCallBack.
To get the current animation started callback function call L_DispContainerGetAnimationStartedCallBack.
To set the current animation stopped callback function call
L_DispContainerSetAnimationStoppedCallBack.
To get the current animation stopped callback function call L_DispContainerGetAnimationStoppedCallBack.
The cell(s) must contain multiple frames.
To start the animation, call the L_DispContainerStartAnimation function.
To stop the animation, call the L_DispContainerStopAnimation function.
To check whether the cell is in an animation phase, call the L_DispContainerIsCellAnimated function.
The user can change or retrieve the animation properties even if the animation has been started.
The user also can change the cell properties, and can apply various actions while the animation is running.
To retrieve the animation properties of a specific cell, call the L_DispContainerGetAnimationProperties function.
To change the animation properties of a specific cell, call the L_DispContainerSetAnimationProperties 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.

Platforms

Windows 95 / 98 / Me, Windows 2000 / XP, Windows CE.

See Also

Functions:	L_DispContainerSetAnimationStartedCallBack, L_DispContainerGetAnimationStartedCallBack, L_DispContainerGetAnimationStoppedCallBack, L_DispContainerSetAnimationStoppedCallBack, L_DispContainerSetAnimationProperties, L_DispContainerGetAnimationProperties, L_DispContainerIsCellAnimated, L_DispContainerStopAnimation, L_DispContainerStartAnimation, L_DispContainerCreate, L_DispContainerRemoveCell, L_DispContainerInsertCell, L_DispContainerGetCellCount, L_DispContainerGetCellWindowHandle, L_DispContainerSetCellTag, L_DispContainerSetCellProperties, L_DispContainerGetCellProperties, L_DispContainerRepositionCell, L_DispContainerGetCellPosition, L_DispContainerSetCellBitmapList, L_DispContainerGetCellBitmapList, L_DispContainerGetCellBounds, L_DispContainerSelectCell, L_DispContainerIsCellSelected, L_DispContainerIsCellFrozen
Topics:	Implementing Animation
	Image Viewer Functions: Implementing Animation

Example