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）。 視窗被殼層遮蓋。 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 組合