EnableThemeDialogTexture function

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

Syntax

HRESULT EnableThemeDialogTexture(
  _In_  HWND hwnd,
  _In_  DWORD dwFlags
);

Parameters

hwnd [in]

Type: HWND

Window handle of the target dialog box.

dwFlags [in]

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

Send comments about this topic to Microsoft

Build date: 10/27/2012