DwmSetWindowAttribute-Funktion (dwmapi.h)
Legt den Wert von DWM-Nicht-Clientrenderungsattributen (Desktop Window Manager) für ein Fenster fest. Programmieranleitungen und Codebeispiele finden Sie unter Steuern des Renderings von Nicht-Clientregionen.
Syntax
HRESULT DwmSetWindowAttribute(
HWND hwnd,
DWORD dwAttribute,
[in] LPCVOID pvAttribute,
DWORD cbAttribute
);
Parameter
hwnd
Das Handle für das Fenster, für das der Attributwert festgelegt werden soll.
dwAttribute
Ein Flag, das den festzulegenden Wert beschreibt, der als Wert der DWMWINDOWATTRIBUTE-Enumeration angegeben wird. Dieser Parameter gibt an, welches Attribut festgelegt werden soll, und der pvAttribute-Parameter verweist auf ein Objekt, das den Attributwert enthält.
[in] pvAttribute
Ein Zeiger auf ein Objekt, das den festzulegenden Attributwert enthält. Der Typ des Wertsatzes hängt vom Wert des dwAttribute-Parameters ab. Das Thema DWMWINDOWATTRIBUTE-Enumeration gibt in der Zeile für jedes Flag an, auf welchen Werttyp Sie im pvAttribute-Parameter einen Zeiger übergeben sollten.
cbAttribute
Die Größe des Attributwerts, der über den pvAttribute-Parameter festgelegt wird, in Bytes. Der Typ des Wertsatzes und damit seine Größe in Bytes hängt vom Wert des dwAttribute-Parameters ab.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Wenn die Desktopkomposition deaktiviert wurde (Windows 7 und früher), gibt diese Funktion DWM_E_COMPOSITIONDISABLED zurück.
Hinweise
Es ist ungültig, diese Funktion aufzurufen, wobei der dwAttribute-Parameter auf DWMWA_NCRENDERING_ENABLED festgelegt ist. Zum Aktivieren oder Deaktivieren des Nicht-Clientrenderings sollten Sie das Attribut DWMWA_NCRENDERING_POLICY verwenden und den gewünschten Wert festlegen. Weitere Informationen und ein Codebeispiel finden Sie unter Steuern des Nichtclientbereichsrenderings.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | dwmapi.h |
Bibliothek | Dwmapi.lib |
DLL | Dwmapi.dll; Uxtheme.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für