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 重要 DWMWA_NCRENDERING_ENABLED 的值为 1。 cpp<br>typedef enum DWMWINDOWATTRIBUTE {<br> DWMWA_NCRENDERING_ENABLED = 1,<br> DWMWA_NCRENDERING_POLICY,<br> ...<br> 与 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）。 遮盖值继承自其所有者窗口。 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 组合