L_CopyBitmapListItems

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_CopyBitmapListItems(phList, hList, uIndex, uCount)

pHBITMAPLIST phList;

/* address of the variable to be updated */

HBITMAPLIST hList;

/* handle to an existing list of bitmaps */

L_UINT uIndex;

/* index of the first bitmap to copy */

L_UINT uCount;

/* number of bitmaps to copy */

Creates a new bitmap list by copying the specified bitmaps from an existing list. Bitmap handles and image data are copied.

Parameter

Description

phList

Address of the variable to be updated with the new list of bitmaps.

hList

Handle to the list of bitmaps to copy from.

uIndex

Index of the first bitmap to copy.

uCount

Number of bitmaps to copy. You can specify (L_UINT) -1 to copy to the end of the existing list.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

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_GetBitmapListCount, L_InsertBitmapListItem,

 

L_RemoveBitmapListItem, L_DeleteBitmapListItems,

 

L_GetBitmapListItem, L_SetBitmapListItem,

 

L_ColorResBitmapList, L_TranslateBitmapColor

Topics:

Raster Image Functions: Playing Animated Images

 

Implementing Animation

Example

/* This example copies all but the first two bitmaps in a list of bitmaps;
then calls another function to save the copied list. */
BITMAPHANDLE LeadBitmap;   /* Bitmap handle for the playback target */
void TestCopyList(HBITMAPLIST hList)
{
   HBITMAPLIST hNewList;
   /* Copy all but the first two bitmaps of the incoming list */
   L_CopyBitmapListItems(&hNewList, hList, 2, (L_UINT) -1);
   /* Call a local function to save the new list */
   TestSaveList(hNewList); /* Refer to the L_SaveBitmapList example */
   return;
}