Edit

Share via

EnableTheming function (uxtheme.h)

  • Article

Windows Vista through Windows 7: Enables or disables visual styles for the current user in the current and later sessions.

Windows 8 and later: This function does nothing. Visual styles are always enabled in Windows 8 and later.

Syntax

HRESULT EnableTheming(
  [in] BOOL fEnable
);

Parameters

[in] fEnable

Type: BOOL

Receives one of the following values.

Value Meaning
TRUE
 Enables visual styles. If the user previously had an active visual style, it becomes active again.
Note  Only clients with trusted computing base (TCB) privileges, where the client acts as part of the operating system, can load or change a global theme.
 
FALSE
 Disables visual styles and turns visual styles off.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

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