Edit

Share via

EnableThemeDialogTexture function (uxtheme.h)

  • Article

Enables or disables the visual style of the background of a dialog window.

Syntax

HRESULT EnableThemeDialogTexture(
  [in] HWND  hwnd,
  [in] DWORD dwFlags
);

Parameters

[in] hwnd

Type: HWND

Window handle of the target dialog box.

[in] dwFlags

Type: DWORD

One of the following option flag values:

Value Meaning
ETDT_DISABLE
 Disables background texturing.
ETDT_ENABLE
 Enables dialog window background texturing. The texturing is defined by a visual style.
ETDT_USETABTEXTURE
 Uses the Tab control texture for the background texture of a dialog window.
ETDT_USEAEROWIZARDTABTEXTURE
 Uses the Aero wizard texture for the background texture of a dialog window.
ETDT_ENABLETAB
 Enables dialog window background texturing. The texture is the Tab control texture defined by the visual style. This flag is equivalent to (ETDT_ENABLE | ETDT_USETABTEXTURE).
ETDT_ENABLEAEROWIZARDTAB
 ETDT_ENABLE | ETDT_USEAEROWIZARDTABTEXTURE.
ETDT_VALIDBITS
 ETDT_DISABLE | ETDT_ENABLE | ETDT_USETABTEXTURE | ETDT_USEAEROWIZARDTABTEXTURE.

Return value

Type: HRESULT

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

Remarks

EnableThemeDialogTexture can be used to tailor dialog box compatibility with child windows and controls that may or may not coordinate rendering their client area backgrounds with that of their parent dialog box.

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