DwmSetWindowAttribute-Funktion (dwmapi.h)

  • Artikel

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