ImageList_Create function

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.

Note  Comctl32.dll version 6 is not redistributable but it is included in Windows or later. To use Comctl32.dll version 6, specify it in a manifest. For more information on manifests, see Enabling Visual Styles.
 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

Library

Comctl32.lib

DLL

Comctl32.dll

 

 

Show: