EnableThemeDialogTexture-Funktion (uxtheme.h)

Artikel
08/26/2023

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

Freigeben über