OpenThemeData function

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

Syntax

void OpenThemeData(
  HWND    hwnd,
  LPCWSTR pszClassList
);

Parameters

hwnd

Type: HWND

Handle of the window for which theme data is required.

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

   
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