LBitmapList::SetItem

#include "ltwrappr.h"

virtual L_INT LBitmapList::SetItem(uIndex, pLBitmap, bReflectIndex=TRUE, puSetIndex=NULL)

L_UINT uIndex;	/* position of the bitmap in the list */
LBitmapBase * pLBitmap;	/* pointer to an LBitmapBase object */
L_BOOL bReflectIndex;	/* flag that indicates whether to set the class object's current index to the passed index */
L_UINT * puSetIndex;	/* pointer to a variable to be updated */

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

Parameter	Description
uIndex	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.
pLBitmap	Pointer to the bitmap object 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.
puSetIndex	Optional pointer to a variable to be updated with the index where the bitmap is set.

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 LBitmapList::GetItem to get a copy of the internal handle, then do the image processing, then update the internal handle using LBitmapList::SetItem.

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

You cannot set a bitmap that belongs to another bitmap list. Also, if the bitmap to be set is an item of the LBitmapList object, then it will be set at the same index specified when getting the bitmap.

The passed bitmap object will be invalidated after this operation.

Required DLLs and Libraries

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.

Functions:	Class Members
Topics:	Raster Image Functions: Playing Animated Images
	Implementing Animation