Share via

ImageList_ExtractIcon

  • Article

This macro calls the ImageList_GetIcon function to create an icon based on an image and mask in an image list.

HICON WINAPI ImageList_ExtractIcon(
HINSTANCE hi, 
HIMAGELIST himl, 
int i );

Parameters

  • hi
    [in] Not used; set to 0.
  • himl
    [in] Handle to the image list.
  • i
    [in] Index of the image.

Return Values

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

Remarks

In Windows CE, you can only use the ImageList_ExtractIcon macro to create an icon, not a cursor.

ImageList_ExtractIcon is not supported for emulation.

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

ImageList_GetIcon

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.