ImageList_Create
The ImageList_Create
function creates a new image list.
HIMAGELIST ImageList_Create(
|
int cx, |
|
|
int cy, |
|
|
UINT flags, |
|
|
int cInitial, |
|
|
int cGrow |
|
|
); |
|
Parameters
cx
Specifies the
width, in pixels, of each image.
cy
Specifies the
height, in pixels, of each image.
flags
A set of bit
flags that specify the type of image list to create. This parameter can be a
combination of the following values, but it can include only one of the
ILC_COLOR values.
|
Value |
Meaning |
|
ILC_COLOR |
Use the
default behavior if none of the other ILC_COLOR* flags is specified.
Typically, the default is ILC_COLOR4; but for older display drivers, the
default is ILC_COLORDDB. |
|
ILC_COLOR4 |
Use a 4-bit
(16 color) device-independent bitmap (DIB) section as the bitmap for the
image list. |
|
ILC_COLOR8 |
Use an
8-bit DIB section. The colors used for the color table are the same colors as
the halftone palette. |
|
ILC_COLOR16 |
Use a
16-bit (32/64k color) DIB section. |
|
ILC_COLOR24 |
Use a
24-bit DIB section. |
|
ILC_COLOR32 |
Use a
32-bit DIB section. |
|
ILC_COLORDDB |
Use a
device-dependent bitmap. |
|
ILC_MASK |
Uses a
mask. The image list contains two bitmaps, one of which is a monochrome bitmap
used as a mask. If this value is not included, the image list contains only
one bitmap. |
cInitial
Number of
images that the image list initially contains.
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.
Return Values
If the
function succeeds, the return value is the handle to the image list.
If the
function fails, the return value NULL.