Freigeben über

DwmSetWindowAttribute-Funktion (dwmapi.h)

  • Artikel

Legt den Wert von Nicht-Client-Renderingattributen für ein Fenster fest. Programmieranleitungen und Codebeispiele finden Sie unter Steuern des Renderns von Nicht-Client-Regionen.

Syntax

HRESULT DwmSetWindowAttribute(
  [in] HWND    hwnd,
  [in] DWORD   dwAttribute,
  [in] LPCVOID pvAttribute,
  [in] DWORD   cbAttribute
);

Parameter

[in] hwnd

Das Handle für das Fenster, für das der Attributwert festgelegt werden soll.

[in] dwAttribute

Ein Flag, das beschreibt, welcher Wert festgelegt werden soll, 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 DWMWINDOWATTRIBUTE Enumerationsthema gibt in der Zeile für jedes Flag an, an welchen Werttyp Sie einen Zeiger im pvAttribute Parameter übergeben sollten.

[in] cbAttribute

Die Größe des Attributwerts, der über den pvAttribute Parameter festgelegt wird. Der Typ des Wertsatzes und daher seine Größe in Byte hängt vom Wert des dwAttribute--Parameters ab.

Rückgabewert

Typ: HRESULT-

Wenn die Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT-Fehlercodezurückgegeben.

Wenn die Desktopkomposition deaktiviert wurde (Windows 7 und früher), gibt diese Funktion DWM_E_COMPOSITIONDISABLEDzurück.

Bemerkungen

Es ist ungültig, diese Funktion aufzurufen, wobei der dwAttribute-parameter auf DWMWA_NCRENDERING_ENABLEDfestgelegt ist. Um das Rendering ohne Client zu aktivieren oder zu deaktivieren, sollten Sie das attribut DWMWA_NCRENDERING_POLICY verwenden und den gewünschten Wert festlegen. Weitere Informationen und ein Codebeispiel finden Sie unter Steuern des Renderns von Nicht-Client-Regionen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- dwmapi.h
Library Dwmapi.lib
DLL- Dwmapi.dll; Uxtheme.dll

Siehe auch