In This Topic ▼

LBitmapList::SetItem

Summary

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

Syntax

#include "ltwrappr.h"

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

Parameters

L_UINT 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.

LBitmapBase * pLBitmap

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

L_BOOL 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.

L_UINT * puSetIndex

Optional pointer to a variable to be updated with the index where the bitmap is set.

Returns

Value	Meaning
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.