Edit

GetThemeAppProperties function (uxtheme.h)

  • Article

Retrieves the property flags that control how visual styles are applied in the current application.

Syntax

DWORD GetThemeAppProperties();

Return value

Type: DWORD

The following return values are bit flags combined with a logical OR operator.

Return code Description
STAP_ALLOW_NONCLIENT
 Specifies that the nonclient areas of application windows have visual styles applied.
STAP_ALLOW_CONTROLS
 Specifies that controls in application windows have visual styles applied.
STAP_ALLOW_WEBCONTENT
 Specifies that all web content displayed in an application is rendered using visual styles.

Remarks

Individual flags can be extracted from the result by combining the result with the logical AND of the desired flag.

Do not call this function during DllMain or global objects constructors. This may cause invalid return values.

Examples

The example extracts a single flag's state from the function result.

DWORD resultFlags = GetThemeAppProperties();
bool ctrlsAreThemed = ((resultFlags & STAP_ALLOW_CONTROLS) != 0);

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 (version 1.0 or later)

See also

SetThemeAppProperties