Share via


ImageList_GetIcon

A version of this page is also available for

Windows Embedded CE 6.0 R3

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_Draw function.

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 DestroyIcon function.

You can only use the ImageList_GetIcon function 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

Reference

DestroyIcon
ImageList_Draw
ImageList_ExtractIcon