L_SetBitmapListItem

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_SetBitmapListItem(hList, uIndex, pBitmap)

HBITMAPLIST hList;

/* handle to the list of bitmaps */

L_UINT uIndex;

/* index of the bitmap to overwrite */

pBITMAPHANDLE pBitmap;

/* pointer to the source bitmap handle */

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

Parameter

Description

hList

Handle to the list of bitmaps.

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.

pBitmap

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

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

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

Required DLLs and Libraries

LTKRN

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_LoadBitmapList, L_SaveBitmapList, L_CreateBitmapList, L_DestroyBitmapList, L_CopyBitmapListItems, L_GetBitmapListCount, L_InsertBitmapListItem, L_RemoveBitmapListItem, L_DeleteBitmapListItems, L_GetBitmapListItem, L_ColorResBitmapList, L_TranslateBitmapColor

Topics:

Raster Image Functions: Playing Animated Images

 

Implementing Animation

Example

For a short example, refer to L_GetBitmapListItem. For complete sample code, refer to the CHILD.C module of the DEMO example.