L_DeleteBitmapListItems

#include "l_bitmap.h"

L_LTKRN_API L_INT L_DeleteBitmapListItems(hList, uIndex, uCount)

HBITMAPLIST hList;	/* handle to the list of bitmaps */
L_UINT uIndex;	/* index of the first bitmap to delete */
L_UINT uCount;	/* number of bitmaps to delete */

Deletes a set of bitmaps from a list. This removes the bitmaps from the specified list and frees the bitmaps.

Parameter	Description
hList	Handle to the list of bitmaps.
uIndex	Index of the first bitmap to delete.
uCount	Number of bitmaps to delete. You can specify (L_UINT) -1 to delete to the end of the list.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

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 2000 / XP/Vista, Windows CE.

See Also

Functions:	L_LoadBitmapList, L_SaveBitmapList,
	L_CreateBitmapList, L_DestroyBitmapList,
	L_CopyBitmapListItems, L_GetBitmapListCount,
	L_InsertBitmapListItem, L_RemoveBitmapListItem,
	L_GetBitmapListItem, L_SetBitmapListItem, L_ColorResBitmapList, L_TranslateBitmapColor
Topics:	Raster Image Functions: Playing Animated Images
	Implementing Animation

Example

This example deletes even numbered bitmaps from a list.

 L_INT DeleteBitmapListItemsExample(HBITMAPLIST hList)
{
   L_INT nRet;
   L_UINT i;      /* Loop counter */
   L_UINT uCount; /* Number of bitmaps in the list */

   /* Delete even numbered bitmaps from the list */
   nRet = L_GetBitmapListCount(hList, &uCount);
   if(nRet != SUCCESS)
      return nRet;
   for (i = 0; i <= uCount/2; i ++)
   {
      nRet = L_DeleteBitmapListItems(hList, i, 1);
      if(nRet != SUCCESS)
         return nRet;
   }
   return SUCCESS;
}