IImageList::GetItemFlags method (commoncontrols.h)

  • Article

Gets the flags of an image.

Syntax

HRESULT GetItemFlags(
  [in]  int   i,
  [out] DWORD *dwFlags
);

Parameters

[in] i

Type: int

A value of type int that contains the index of the images whose flags need to be retrieved.

[out] dwFlags

Type: DWORD*

A pointer to a DWORD that contains the flags when the method returns. One of the following values:

Value Meaning
ILIF_ALPHA
0x00000001
 Indicates that the item in the imagelist has an alpha channel.
ILIF_LOWQUALITY
0x00000002
 Windows Vista and later. Indicates that the item in the imagelist was generated via a StretchBlt function, consequently image quality may have degraded.

Return value

Type: HRESULT

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

Remarks

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

Requirements

Requirement Value
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)