SetWindowTheme-Funktion (uxtheme.h)

Artikel
08/26/2023

Bewirkt, dass ein Fenster einen anderen Satz visueller Stilinformationen verwendet, als seine Klasse normalerweise verwendet.

Syntax

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

Parameter

[in] hwnd

Typ: HWND

Handle mit dem Fenster, dessen visuelle Stilinformationen geändert werden sollen.

[in] pszSubAppName

Typ: LPCWSTR

Zeiger 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

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

Rückgabewert

Typ: HRESULT

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

Hinweise

Der Design-Manager behält die Zuordnungen pszSubAppName und pszSubIdList während der gesamten Lebensdauer des Fensters bei, auch wenn sich die visuellen Stile anschließend ändern. Das Fenster wird am Ende eines SetWindowTheme-Aufrufs eine WM_THEMECHANGED Nachricht gesendet, sodass der neue visuelle Stil gefunden und angewendet werden kann.

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

Beispiele

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

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

Anforderungen

Anforderung	Wert
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