IImageList::GetIcon method

Creates an icon from an image and a mask in an image list.

Syntax

HRESULT GetIcon(
  int   i,
  UINT  flags,
  HICON *picon
);

Parameters

i

Type: int

A value of type int that contains the index of the image.

flags

Type: UINT

A combination of flags that specify the drawing style. For a list of values, see IImageList::Draw.

picon

Type: HICON*

A pointer to an int that contains the handle to the icon if successful, or NULL if otherwise.

Return Value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The calling application must destroy the icon returned from this method using DestroyIcon.

To use IImageList::GetIcon, specify Comctl32.dll version 6 in the manifest. For more information on manifests, see Enabling Visual Styles.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header commoncontrols.h
DLL Comctl32.dll (version 6.0 or later)