ImageList_GetImageInfo function (commctrl.h)

Retrieves information about an image.

Syntax

BOOL ImageList_GetImageInfo(
  HIMAGELIST himl,
  int        i,
  IMAGEINFO  *pImageInfo
);

Parameters

himl

Type: HIMAGELIST

A handle to the image list.

i

Type: int

The index of the image.

pImageInfo

Type: IMAGEINFO*

A pointer to an IMAGEINFO structure that receives information about the image. The information in this structure can be used to directly manipulate the bitmaps for the image.

Return value

Type: BOOL

Returns nonzero if successful, or zero otherwise.

Remarks

An application should not call DeleteObject to destroy the bitmaps retrieved by ImageList_GetImageInfo. The system destroys the bitmaps when the application calls the ImageList_Destroy 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
Library Comctl32.lib
DLL Comctl32.dll