ImageList_Create

This function creates a new image list.

HIMAGELIST WINAPI ImageList_Create(
int cx, 
int cy, 
UINT flags, 
int cInitial, 
int cGrow ); 

Parameters

• cx
  [in] Width, in pixels, of each image.

• cy
  [in] Height, in pixels, of each image.

• flags
  [in] 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	Description
  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_COLORDDB	Use a device-dependent bitmap.
  ILC_MASK	Use 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
  [in] Number of images that the image list initially contains.

• cGrow
  [in] Number of images by which the image list can grow when the system needs to make room for new images. This parameter represents the number of new images that the resized image list can contain.

Return Values

The handle to the image list indicates success. NULL indicates failure.

Requirements

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.