DwmSetWindowAttribute 函数 (dwmapi.h)

设置窗口管理器(DWM)非客户端呈现属性的值。 有关编程指南和代码示例,请参阅 控制非客户端区域呈现

语法

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

参数

[in] hwnd

要为其设置属性值的窗口的句柄。

[in] dwAttribute

描述要设置的值的标志,指定为 DWMWINDOWATTRIBUTE 枚举的值。 此参数指定要设置的属性,pvAttribute 参数指向包含属性值的对象。

[in] pvAttribute

指向包含要设置的属性值的对象的指针。 值集的类型取决于 dwAttribute 参数的值。 DWMWINDOWATTRIBUTE 枚举主题指示,在每个标志的行中,应向 pvAttribute 参数传递指向的值类型。

[in] cbAttribute

通过 pvAttribute 参数设置的属性值的大小(以字节为单位)。 值集的类型及其大小(以字节为单位)取决于 dwAttribute 参数的值。

返回值

类型:HRESULT

如果函数成功,则返回 S_OK。 否则,它将返回 HRESULT错误代码

如果桌面合成已被禁用(Windows 7 及更早版本),则此函数将返回 DWM_E_COMPOSITIONDISABLED

言论

调用此函数无效,dwAttribute 参数设置为 DWMWA_NCRENDERING_ENABLED。 若要启用或禁用非客户端呈现,应使用 DWMWA_NCRENDERING_POLICY 属性并设置所需的值。 有关详细信息和代码示例,请参阅 控制非客户端区域呈现

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 dwmapi.h
Dwmapi.lib
DLL Dwmapi.dll;Uxtheme.dll

另请参阅