Edit

Share via

OpenThemeDataEx function (uxtheme.h)

  • Article

Opens the theme data associated with a window for specified theme classes.

Syntax

HTHEME OpenThemeDataEx(
  [in] HWND    hwnd,
  [in] LPCWSTR pszClassList,
  [in] DWORD   dwFlags
);

Parameters

[in] hwnd

Type: HWND

A handle to a window or control that the theme is to be retrieved from.

[in] pszClassList

Type: LPCWSTR

A semicolon-separated list of class names to match.

[in] dwFlags

Type: DWORD

Optional flags that control how to return the theme data. May be set to a combination of the following values.

Value Meaning
OTD_FORCE_RECT_SIZING
 Forces drawn images from this theme to stretch to fit the rectangles specified by drawing functions.
OTD_NONCLIENT
 Allows theme elements to be drawn in the non-client area of the window.

Return value

Type: HTHEME

If a match is found, a valid handle to a theme is returned. Otherwise, a NULL value will be returned.

Remarks

The string specified by pszClassIdList will be tokenized using semicolons as a delimiter. The names are matched against class names one token at a time. If no match is found for a particular token, the next token will be matched. If a match is found, the return value of the function will be the theme handle associated with the matched class.

Class names for the Aero theme are defined in AeroStyle.xml.

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

OpenThemeData