ImageList_GetIcon function (commctrl.h)

Creates an icon from an image and mask in an image list.

Syntax

HICON ImageList_GetIcon(
  HIMAGELIST himl,
  int        i,
  UINT       flags
);

Parameters

himl

Type: HIMAGELIST

A handle to the image list.

i

Type: int

An index of the image.

flags

Type: UINT

A combination of flags that specify the drawing style. For a list of values, see the description of the fStyle parameter of the ImageList_Draw function.

Return value

Type: HICON

Returns the handle to the icon if successful, or NULL otherwise.

Remarks

It is the responsibility of the calling application to destroy the icon returned from this function using the DestroyIcon function.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header commctrl.h
Library Comctl32.lib
DLL Comctl32.dll