SetWindowTheme-Funktion (uxtheme.h)
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 |