ImageList_Create function (commctrl.h)

• 12/05/2018
• 2 minutes to read

Creates a new image list.

Syntax

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

Parameters

cx

Type: int

The width, in pixels, of each image.

cy

Type: int

The height, in pixels, of each image.

flags

Type: UINT

A set of bit flags that specify the type of image list to create. This parameter can be a combination of the Image List Creation Flags.

cInitial

Type: int

The number of images that the image list initially contains.

cGrow

Type: int

The 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 value

Type: HIMAGELIST

Returns the handle to the image list if successful, or NULL otherwise.

Remarks

When you finish using the image list, destroy it by calling the ImageList_Destroy function.

Requirements