Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
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 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

Minimum supported client

Windows Vista [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:
© 2015 Microsoft