LBitmapList::DeleteItems

#include "ltwrappr.h"

virtual L_INT LBitmapList::DeleteItems(uIndex, uCount=1)

L_UINT uIndex;	/* index of the first bitmap to delete */
L_UINT uCount;	/* number of bitmaps to delete */

Deletes a set of bitmaps from the class object's bitmap list.

Parameter	Description
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

This removes the bitmaps from the class object's bitmap list and frees the bitmaps.

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

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.

See Also

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

Example

L_VOID DeleteItemsSamples(HWND hWnd)
{
   LBitmapList BitmapList;
   LBitmapBase Bitmap;
   L_TCHAR szDummyBuffer[50];
   L_INT nCount;

   BitmapList.Create ();
   // load three images and insert them in the list
   Bitmap.Load(TEXT("image1.cmp"), 0,ORDER_BGR);
   BitmapList.InsertItem (&Bitmap);
   Bitmap.Load(TEXT("image2.cmp"), 0,ORDER_BGR);
   BitmapList.InsertItem (&Bitmap);
   Bitmap.Load(TEXT("image3.cmp"), 0,ORDER_BGR);
   BitmapList.InsertItem (&Bitmap);

   // Delete all items
   BitmapList.DeleteItems (0, BitmapList.GetItemsCount ());
   nCount = BitmapList.GetItemsCount ();
   wsprintf(szDummyBuffer, TEXT("List contains %d items."), nCount);
   MessageBox(hWnd, szDummyBuffer, TEXT("LBitmapList"), MB_OK);
}