DWMWINDOWATTRIBUTE 枚举 (dwmapi.h)

DwmGetWindowAttribute 和 DwmSetWindowAttribute 函数使用的选项。

语法

typedef enum DWMWINDOWATTRIBUTE {
  DWMWA_NCRENDERING_ENABLED,
  DWMWA_NCRENDERING_POLICY,
  DWMWA_TRANSITIONS_FORCEDISABLED,
  DWMWA_ALLOW_NCPAINT,
  DWMWA_CAPTION_BUTTON_BOUNDS,
  DWMWA_NONCLIENT_RTL_LAYOUT,
  DWMWA_FORCE_ICONIC_REPRESENTATION,
  DWMWA_FLIP3D_POLICY,
  DWMWA_EXTENDED_FRAME_BOUNDS,
  DWMWA_HAS_ICONIC_BITMAP,
  DWMWA_DISALLOW_PEEK,
  DWMWA_EXCLUDED_FROM_PEEK,
  DWMWA_CLOAK,
  DWMWA_CLOAKED,
  DWMWA_FREEZE_REPRESENTATION,
  DWMWA_PASSIVE_UPDATE_MODE,
  DWMWA_USE_HOSTBACKDROPBRUSH,
  DWMWA_USE_IMMERSIVE_DARK_MODE = 20,
  DWMWA_WINDOW_CORNER_PREFERENCE = 33,
  DWMWA_BORDER_COLOR,
  DWMWA_CAPTION_COLOR,
  DWMWA_TEXT_COLOR,
  DWMWA_VISIBLE_FRAME_BORDER_THICKNESS,
  DWMWA_SYSTEMBACKDROP_TYPE,
  DWMWA_LAST
} ;

常量

DWMWA_NCRENDERING_ENABLED 与 DwmGetWindowAttribute 一起使用。 发现是否启用了非客户端呈现。 检索到的值的类型为 BOOL。 如果启用非客户端呈现，则为 TRUE;否则为 FALSE。
DWMWA_NCRENDERING_POLICY 与 DwmSetWindowAttribute 一起使用。 设置非客户端呈现策略。 pvAttribute 参数指向 DWMNCRENDERINGPOLICY 枚举中的值。
DWMWA_TRANSITIONS_FORCEDISABLED 与 DwmSetWindowAttribute 一起使用。 启用或强制禁用 DWM 转换。 pvAttribute 参数指向 BOOL 类型的值。 如果为 TRUE ，则禁用转换; 如果为 FALSE ，则为启用转换。
DWMWA_ALLOW_NCPAINT 与 DwmSetWindowAttribute 一起使用。 使非工作区中呈现的内容在 DWM 绘制的帧上可见。 pvAttribute 参数指向 BOOL 类型的值。 如果为 TRUE ，则启用在非工作区中呈现的内容在帧上可见;否则为 FALSE。
DWMWA_CAPTION_BUTTON_BOUNDS 与 DwmGetWindowAttribute 一起使用。 检索窗口相对空间中描述文字按钮区域的边界。 检索到的值的类型为 RECT。 如果窗口最小化或对用户不可见，则检索到的 RECT 的值未定义。 应检查检索到的 RECT 是否包含可以使用的边界，如果没有，则可以认为窗口已最小化或不可见。
DWMWA_NONCLIENT_RTL_LAYOUT 与 DwmSetWindowAttribute 一起使用。 指定非客户端内容是否为从右到左 (RTL) 镜像。 pvAttribute 参数指向 BOOL 类型的值。 如果非客户端内容从右到左 (RTL) 镜像，则为 TRUE;否则为 FALSE。
DWMWA_FORCE_ICONIC_REPRESENTATION 与 DwmSetWindowAttribute 一起使用。 强制窗口显示图标缩略图或速览表示形式 (静态位图) ，即使窗口的实时或快照表示形式可用。 此值通常在创建窗口期间设置，在窗口的整个生存期内不会更改。 但是，某些方案可能需要值随时间推移而更改。 pvAttribute 参数指向 BOOL 类型的值。 如果为 TRUE ，则要求使用图标缩略图或速览表示形式;否则为 FALSE。
DWMWA_FLIP3D_POLICY 与 DwmSetWindowAttribute 一起使用。 设置 Flip3D 如何处理窗口。 pvAttribute 参数指向DWMFLIP3DWINDOWPOLICY枚举中的值。
DWMWA_EXTENDED_FRAME_BOUNDS 与 DwmGetWindowAttribute 一起使用。 检索屏幕空间中的扩展框架边界矩形。 检索到的值的类型为 RECT。
DWMWA_HAS_ICONIC_BITMAP 与 DwmSetWindowAttribute 一起使用。 窗口将提供一个位图，供 DWM 用作图标缩略图或速览表示形式， (窗口的静态位图) 。 可以使用 DWMWA_FORCE_ICONIC_REPRESENTATION 指定 DWMWA_HAS_ICONIC_BITMAP。 DWMWA_HAS_ICONIC_BITMAP 通常在创建窗口期间设置，在窗口的整个生存期内不会更改。 但是，某些方案可能需要值随时间推移而更改。 pvAttribute 参数指向 BOOL 类型的值。 如果为 TRUE ，则通知 DWM 窗口将提供图标缩略图或速览表示形式;否则为 FALSE。 Windows Vista 及更早版本： 不支持此值。
DWMWA_DISALLOW_PEEK 与 DwmSetWindowAttribute 一起使用。 不显示窗口的速览预览。 当鼠标悬停在任务栏中窗口的缩略图上时，速览视图会显示窗口的全尺寸预览。 如果设置了此属性，将鼠标指针悬停在窗口的缩略图上会消除速览 (以防组中的另一个窗口具有显示) 的速览预览。 pvAttribute 参数指向 BOOL 类型的值。 如果为 TRUE ，则阻止速览功能; 如果为 FALSE ，则允许它。 Windows Vista 及更早版本： 不支持此值。
DWMWA_EXCLUDED_FROM_PEEK 与 DwmSetWindowAttribute 一起使用。 防止在调用速览时窗口褪色到玻璃板。 pvAttribute 参数指向 BOOL 类型的值。 如果为 TRUE ，则防止窗口在另一个窗口的速览期间褪色;对于正常行为，则为 FALSE 。 Windows Vista 及更早版本： 不支持此值。
DWMWA_CLOAK 与 DwmSetWindowAttribute 一起使用。 遮盖窗口，使其对用户不可见。 窗口仍由 DWM 组成。 与 DirectComposition 一起使用： 当通过与分层子窗口关联的 DirectComposition 视觉对象对窗口内容的表示形式进行动画处理时，请使用 DWMWA_CLOAK 标志来遮盖分层子窗口。 有关此用例的更多详细信息，请参阅 如何对分层子窗口的位图进行动画处理。 Windows 7 及更早版本： 不支持此值。
DWMWA_CLOAKED 与 DwmGetWindowAttribute 一起使用。 如果窗口被遮盖，请提供以下值之一来解释原因。 DWM_CLOAKED_APP (值0x00000001) 。 窗口被其所有者应用程序遮盖。 DWM_CLOAKED_SHELL (值0x00000002) 。 窗户被 Shell 遮盖了。 DWM_CLOAKED_INHERITED (值0x00000004) 。 cloak 值继承自其所有者窗口。 Windows 7 及更早版本： 不支持此值。
DWMWA_FREEZE_REPRESENTATION 与 DwmSetWindowAttribute 一起使用。 使用当前视觉对象冻结窗口的缩略图。 不要对缩略图执行进一步的实时更新，以匹配窗口的内容。 Windows 7 及更早版本： 不支持此值。
DWMWA_USE_HOSTBACKDROPBRUSH 与 DwmSetWindowAttribute 一起使用。 允许非 UWP 窗口使用主机背景画笔。 如果设置了此标志，则调用 Windows：：UI：：Composition API 的 Win32 应用可以使用主机背景画笔生成透明度效果 (请参阅 Compositor.CreateHostBackdropBrush) 。 pvAttribute 参数指向 BOOL 类型的值。 如果为 TRUE ，则为窗口启用主机背景画笔，如果为 FALSE ，则禁用它。 从 Windows 11 内部版本 22000 开始支持此值。
DWMWA_USE_IMMERSIVE_DARK_MODE 与 DwmSetWindowAttribute 一起使用。 启用深色模式系统设置时，允许以深色模式绘制此窗口的窗口框架。 出于兼容性原因，无论系统设置如何，所有窗口都默认为浅色模式。 pvAttribute 参数指向 BOOL 类型的值。 如果为 TRUE ，则为窗口采用深色模式， 如果为 FALSE ，则始终使用浅色模式。 从 Windows 11 内部版本 22000 开始支持此值。
DWMWA_WINDOW_CORNER_PREFERENCE 与 DwmSetWindowAttribute 一起使用。 指定窗口的圆角首选项。 pvAttribute 参数指向 DWM_WINDOW_CORNER_PREFERENCE 类型的值。 从 Windows 11 内部版本 22000 开始支持此值。
DWMWA_BORDER_COLOR 与 DwmSetWindowAttribute 一起使用。 指定窗口边框的颜色。 pvAttribute 参数指向 COLORREF 类型的值。 应用负责根据状态更改（例如窗口激活中的更改）更改边框颜色。 为颜色指定 DWMWA_COLOR_NONE (值0xFFFFFFFE) 将禁止绘制窗口边框。 这样就可以有一个没有边框的圆角窗口。 为颜色指定 DWMWA_COLOR_DEFAULT (值0xFFFFFFFF) 会将窗口重置回使用系统对边框颜色的默认行为。 从 Windows 11 版本 22000 开始支持此值。
DWMWA_CAPTION_COLOR 与 DwmSetWindowAttribute 一起使用。 指定描述文字的颜色。 pvAttribute 参数指向 COLORREF 类型的值。 为颜色指定DWMWA_COLOR_DEFAULT (值0xFFFFFFFF) 会将窗口重置回使用系统对描述文字颜色的默认行为。 从 Windows 11 版本 22000 开始支持此值。
DWMWA_TEXT_COLOR 与 DwmSetWindowAttribute 一起使用。 指定描述文字文本的颜色。 pvAttribute 参数指向 COLORREF 类型的值。 为颜色指定DWMWA_COLOR_DEFAULT (值0xFFFFFFFF) 会将窗口重置回使用系统对描述文字文本颜色的默认行为。 从 Windows 11 版本 22000 开始支持此值。
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS 与 DwmGetWindowAttribute 一起使用。 检索 DWM 将围绕此窗口绘制的外部边框的宽度。 该值可能因窗口的 DPI 而异。 pvAttribute 参数指向 UINT 类型的值。 从 Windows 11 版本 22000 开始支持此值。
DWMWA_SYSTEMBACKDROP_TYPE 与 DwmGetWindowAttribute 或 DwmSetWindowAttribute 一起使用。 检索或指定窗口的系统绘制背景材料，包括非工作区后面。 pvAttribute 参数指向 DWM_SYSTEMBACKDROP_TYPE 类型的值。 从 Windows 11 版本 22621 开始支持此值。
DWMWA_LAST 最大可识别的 DWMWINDOWATTRIBUTE 值，用于验证目的。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	dwmapi.h

另请参阅

• DwmGetWindowAttribute 函数
• DwmSetWindowAttribute 函数
• 启用和控制 DWM 组合