ImageList_GetIcon

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

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 Values

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

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h   Commctrl.lib, Imgctl.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

DestroyIcon, ImageList_Draw, ImageList_ExtractIcon

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.