OpenThemeData function (uxtheme.h)

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


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


[in] hwnd

Type: HWND

Handle of the window for which theme data is required.

[in] pszClassList


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

Return value


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.


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.


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