Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
- DwmGetWindowAttribute-Funktion
- DWM-Komposition aktivieren und steuern