EnableThemeDialogTexture-Funktion (uxtheme.h)

  • Artikel

Aktiviert oder deaktiviert den visuellen Stil des Hintergrunds eines Dialogfelds.

Syntax

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

Parameter

[in] hwnd

Typ: HWND

Fensterhandle des Zieldialogfelds.

[in] dwFlags

Typ: DWORD

Einer der folgenden Optionsflagwerte:

Wert Bedeutung
ETDT_DISABLE
 Deaktiviert die Hintergrundtexturierung.
ETDT_ENABLE
 Aktiviert die Hintergrundtexturierung im Dialogfeld. Die Texturierung wird durch einen visuellen Stil definiert.
ETDT_USETABTEXTURE
 Verwendet die Registerkarten-Steuerelementtextur für die Hintergrundtextur eines Dialogfelds.
ETDT_USEAEROWIZARDTABTEXTURE
 Verwendet die Textur des Aero-Assistenten für die Hintergrundtextur eines Dialogfelds.
ETDT_ENABLETAB
 Aktiviert die Hintergrundtexturierung im Dialogfeld. Die Textur ist die Textur des Tabstopp-Steuerelements, die durch den visuellen Stil definiert wird. Dieses Flag entspricht (ETDT_ENABLE | ETDT_USETABTEXTURE).
ETDT_ENABLEAEROWIZARDTAB
 ETDT_ENABLE | ETDT_USEAEROWIZARDTABTEXTURE.
ETDT_VALIDBITS
 ETDT_DISABLE | ETDT_ENABLE | ETDT_USETABTEXTURE | ETDT_USEAEROWIZARDTABTEXTURE.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

EnableThemeDialogTexture kann verwendet werden, um die Dialogfeldkompatibilität mit untergeordneten Fenstern und Steuerelementen anzupassen, die das Rendern ihrer Clientbereichshintergründe mit dem des übergeordneten Dialogfelds koordinieren oder nicht.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uxtheme.h
Bibliothek UxTheme.lib
DLL UxTheme.dll