ImageList_LoadBitmap

Overview

Group

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
Yes
Import Library
comctl32.lib
Header File
commctrl.h
Unicode
No
Platform Notes
None

The ImageList_LoadBitmap function creates an image list from the specified bitmap resource. ImageList_LoadBitmap is a macro that calls the ImageList_LoadImage function.

HIMAGELIST ImageList_LoadBitmap(

HINSTANCE hi,
LPCSTR lpbmp,
int cx,
int cGrow,
COLORREF crMask
);

Parameters
hi

Handle to the instance that contains the bitmap resource.

lpbmp

Name of the resource.

Width of each image. The height of each image and the initial number of images are inferred by the dimensions of the specified bitmap.

cGrow

Amount of images by which the image list can grow when the system needs to resize the list to make room for new images. This parameter represents the number of new images that the resized image list can contain.

crMask

Color used to generate a mask. Each pixel of this color in the specified bitmap is changed to black, and the corresponding bit in the mask is set to one. If this parameter is the CLR_NONE value, no mask is generated.

Return Values
If the function succeeds, the return value is the image list.

If the function fails, the return value is NULL.