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