DrawThemeIcon function (uxtheme.h)

Draws an image from an image list with the icon effect defined by the visual style.

Syntax

HRESULT DrawThemeIcon(
  [in] HTHEME     hTheme,
  [in] HDC        hdc,
  [in] int        iPartId,
  [in] int        iStateId,
  [in] LPCRECT    pRect,
  [in] HIMAGELIST himl,
  [in] int        iImageIndex
);

Parameters

[in] hTheme

Type: HTHEME

Handle to a window's specified theme data. Use OpenThemeData to create an HTHEME.

[in] hdc

Type: HDC

HDC.

[in] iPartId

Type: int

Value of type int that specifies the part in which the image is drawn. See Parts and States.

[in] iStateId

Type: int

Value of type int that specifies the state of the part. See Parts and States.

[in] pRect

Type: LPCRECT

Pointer to a RECT structure that contains, in logical coordinates, the rectangle in which the image is drawn.

[in] himl

Type: HIMAGELIST

Handle to an image list that contains the image to draw.

[in] iImageIndex

Type: int

Value of type int that specifies the index of the image to draw.

Return value

Type: HRESULT

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

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header uxtheme.h
Library UxTheme.lib
DLL UxTheme.dll

See also

IImageList

Property Identifiers

Reference