LAnimationWindow::SetAt

#include "ltwrappr.h"

L_INT LAnimationWindow::SetAt(nIndex, pBitmap, bReflectIndex = FALSE)

L_UINT nIndex;

/* index of the bitmap to overwrite */

LBitmapBase * pBitmap;

/* pointer to the source bitmap handle */

L_BOOL bReflectIndex;

/* flag that indicates whether to set the class object's current index to the passed index */

Overwrites the internal bitmap handle of a bitmap in a list. Use this function with LAnimationWindow::GetAt to manipulate a bitmap in a list.

Parameter

Description

nIndex

Position of the bitmap in the list. Use zero-based indexing. For example, if there are 10 bitmaps in a list, the index of the last one is 9.

pBitmap

Pointer to the bitmap handle that will overwrite the internal bitmap handle in the list.

bReflectIndex

Flag that indicates whether to set the class object's current index to the passed index. Possible values are:

 

Value

Meaning

 

TRUE

Set the class object's current index to the passed index.

 

FALSE

Do not set the class object's current index to the passed index.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

When a bitmap is in a list, you do not have direct access to the bitmap handle. Therefore, to do any image processing, you must first use LAnimationWindow::GetAt to get a copy of the internal handle, then do the image processing, then update the internal handle using LAnimationWindow::SetAt.

You cannot use this method to update a bitmap list while it is being used in an animation playback.

Required DLLs and Libraries

LTKRN
LTFIL
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:

Class Members

Topics:

Raster Image Functions: Playing Animated Images

 

Implementing Animation

Example

For an example, refer to LAnimationWindow::GetAt.