ImageList_ExtractIcon macro

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

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

 

 

Show: