ImageList_ExtractIcon macro (commctrl.h)

Calls the ImageList_GetIcon function to create an icon or cursor based on an image and mask in an image list.

Syntax

void ImageList_ExtractIcon(
   hi,
   himl,
   i
);

Parameters

hi

Type: HINSTANCE

This parameter is not used and should always be zero.

himl

Type: HIMAGELIST

A handle to the image list.

i

Type: int

The index of the image.

Return value

None

Remarks

It is the responsibility of the calling application to destroy the icon returned from this function by 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