Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function creates an icon from an image and mask in an image list.

Syntax 

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

Parameters

himl

[in] Handle to the image list.

i

[in] Index of the image.

flags

[in] Combination of flags that specify the drawing style. For a list of values, see the description of the ImageList_Drawfunction.

Return Value

The handle to the icon indicates success. NULL indicates failure.

Remarks

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

You can only use the ImageList_GetIconfunction to create an icon, not a cursor.

Requirements

Header commctrl.h
Library commctrl.lib, Imgctl.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also