dwmSetWindowAttribute 函数 (dwmapi.h)
设置桌面窗口管理器的值 (DWM) 窗口的非客户端呈现属性。 有关编程指南和代码示例,请参阅 控制非客户端区域呈现。
语法
HRESULT DwmSetWindowAttribute(
HWND hwnd,
DWORD dwAttribute,
[in] LPCVOID pvAttribute,
DWORD cbAttribute
);
参数
hwnd
要为其设置属性值的窗口的句柄。
dwAttribute
描述要设置的值的标志,指定为 DWMWINDOWATTRIBUTE 枚举的值。 此参数指定要设置的属性, pvAttribute 参数指向包含属性值的对象。
[in] pvAttribute
指向包含要设置的属性值的 对象的指针。 设置的值的类型取决于 dwAttribute 参数的值。 DWMWINDOWATTRIBUTE 枚举主题在每个标志的行中指示应在 pvAttribute 参数中将指针传递给的值的类型。
cbAttribute
通过 pvAttribute 参数设置的属性值的大小(以字节为单位)。 设置的值的类型,因此其大小(以字节为单位)取决于 dwAttribute 参数的值。
返回值
类型: HRESULT
如果函数成功,则返回 S_OK。 否则,它将返回 HRESULT错误代码。
如果已 (Windows 7 及更早版本) 禁用桌面合成,则此函数返回 DWM_E_COMPOSITIONDISABLED。
注解
如果 dwAttribute 参数设置为 DWMWA_NCRENDERING_ENABLED,则调用此函数无效。 若要启用或禁用非客户端呈现,应使用 DWMWA_NCRENDERING_POLICY 属性,并设置所需的值。 有关详细信息和代码示例,请参阅 控制非客户端区域呈现。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | dwmapi.h |
Library | Dwmapi.lib |
DLL | Dwmapi.dll;Uxtheme.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈