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

HICON ImageList_ExtractIcon(
   HINSTANCE  hi,
   HIMAGELIST himl,
   int        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

Type: HICON

Returns the handle of the icon or cursor if successful, or NULL otherwise.

Remarks

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

Requirements