OpenThemeDataEx function

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

Syntax

void OpenThemeDataEx(
  HWND    hwnd,
  LPCWSTR pszClassList,
  DWORD   dwFlags
);

Parameters

hwnd

Type: HWND

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

pszClassList

Type: LPCWSTR

A semicolon-separated list of class names to match.

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

   
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