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

Win32, x64.

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;
}