Export (0) Print
Expand All
Expand Minimize

GetThemeAppProperties function

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

Syntax


DWORD GetThemeAppProperties(void);

Parameters

This function has no parameters.

Return value

Type: DWORD

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

Return codeDescription
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 contructors. This may cause invalid return values in Windows Vista and may cause Windows XP to become unstable.

Examples

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


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


Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Uxtheme.h

Library

UxTheme.lib

DLL

UxTheme.dll (version 1.0 or later)

See also

SetThemeAppProperties

 

 

Community Additions

ADD
Show:
© 2014 Microsoft