OpenThemeData function (uxtheme.h)

Opens the theme data for a window and its associated class.

Syntax

HTHEME OpenThemeData(
  [in] HWND    hwnd,
  [in] LPCWSTR pszClassList
);

Parameters

[in] hwnd

Type: HWND

Handle of the window for which theme data is required.

[in] pszClassList

Type: LPCWSTR

Pointer to a string that contains a semicolon-separated list of classes.

Return value

Type: HTHEME

OpenThemeData tries to match each class, one at a time, to a class data section in the active theme. If a match is found, an associated HTHEME handle is returned. If no match is found NULL is returned.

Remarks

The pszClassList parameter contains a list, not just a single name, to provide the class an opportunity to get the best match between the class and the current visual style. For example, a button might pass L"OkButton;Button" if its ID is ID_OK. If the current visual style has an entry for OkButton, that is used; otherwise no visual style is applied.

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

CloseThemeData