SetWindowTheme-Funktion (uxtheme.h)

Artikel
02/22/2025

Bewirkt, dass ein Fenster einen anderen Satz visueller Formatvorlageninformationen verwendet, als die Klasse normalerweise verwendet.

Syntax

HRESULT SetWindowTheme(
  [in] HWND    hwnd,
  [in] LPCWSTR pszSubAppName,
  [in] LPCWSTR pszSubIdList
);

Parameter

[in] hwnd

Typ: HWND-

Behandeln Sie das Fenster, dessen Visuelle Formatinformationen geändert werden sollen.

[in] pszSubAppName

Typ: LPCWSTR-

Zeigen Sie auf eine Zeichenfolge, die den Anwendungsnamen enthält, der anstelle des Namens der aufrufenden Anwendung verwendet werden soll. Wenn dieser Parameter NULL-ist, wird der Name der aufrufenden Anwendung verwendet.

[in] pszSubIdList

Typ: LPCWSTR-

Zeigen Sie auf eine Zeichenfolge, die eine durch Semikolons getrennte Liste von CLSID-Namen enthält, die anstelle der tatsächlichen Liste verwendet werden, die von der Klasse des Fensters übergeben wird. Wenn dieser Parameter NULL-ist, wird die ID-Liste aus der aufrufenden Klasse verwendet.

Rückgabewert

Typ: HRESULT-

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

Bemerkungen

Der Design-Manager behält die pszSubAppName und die pszSubIdList- Zuordnungen über die Lebensdauer des Fensters bei, auch wenn sich anschließend visuelle Formatvorlagen ändern. Das Fenster wird am Ende eines SetWindowTheme- aufrufs eine WM_THEMECHANGED Nachricht gesendet, sodass die neue visuelle Formatvorlage gefunden und angewendet werden kann.

Wenn pszSubAppName und pszSubIdListNULL-sind, entfernt der Design-Manager die zuvor angewendeten Zuordnungen. Sie können verhindern, dass visuelle Formatvorlagen auf ein angegebenes Fenster angewendet werden, indem Sie eine leere Zeichenfolge (L") angeben, die keinen Abschnittseinträgen entspricht.

Beispiele

Der folgende Beispielcode gibt einem Listenansicht-Steuerelement die Darstellung einer Windows Explorer-Liste:

SetWindowTheme(hwndList, L"Explorer", NULL);

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	uxtheme.h
Library	UxTheme.lib
DLL-	UxTheme.dll

Freigeben über