Available in LEADTOOLS Imaging Pro, Vector, Document, and Medical Imaging toolkits. |
#include "l_bitmap.h"
L_LTKRN_API L_INT L_SetBitmapListItem(hList, uIndex, pBitmap)
HBITMAPLIST hList; |
/* handle to the list of bitmaps */ |
L_UINT uIndex; |
/* index of the bitmap to overwrite */ |
pBITMAPHANDLE pBitmap; |
/* pointer to the source bitmap handle */ |
Overwrites the internal bitmap handle of a bitmap in a list. Use this function with L_GetBitmapListItem to manipulate a bitmap in a list.
Parameter |
Description |
hList |
Handle to the list of bitmaps. |
uIndex |
Position of the bitmap in the list. Use zero-based indexing. For example, if there are 10 bitmaps in a list, the index of the last one is 9. |
pBitmap |
Pointer to the bitmap handle that will overwrite the internal bitmap handle in the list. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
When a bitmap is in a list, you do not have direct access to the bitmap handle. Therefore, to do any image processing, you must first use L_GetBitmapListItem to get a copy of the internal handle, then do the image processing, then update the internal handle using L_SetBitmapListItem.
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
Example
For a short example, refer to L_GetBitmapListItem. For complete sample code, refer to the CHILD.C module of the DEMO example.