DWMWINDOWATTRIBUTE 列舉 (dwmapi.h)

  • 發行項

DwmGetWindowAttribute 和 DwmSetWindowAttribute 函式所使用的選項。

Syntax

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) 。 視窗已由殼層遮蔽。

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) ，將會使用框線色彩的系統預設行為，將視窗重設為 。

從組建 22000 開始，支援此值 Windows 11。
DWMWA_CAPTION_COLOR
搭配 DwmSetWindowAttribute 使用。 指定 標題 的色彩。 pvAttribute 參數指向 COLORREF 類型的值。

針對色彩指定DWMWA_COLOR_DEFAULT (值0xFFFFFFFF) ，將會使用 標題 色彩的系統預設行為，將視窗重設為 。

從組建 22000 開始，支援此值 Windows 11。
DWMWA_TEXT_COLOR
搭配 DwmSetWindowAttribute 使用。 指定 標題 文字的色彩。 pvAttribute 參數指向 COLORREF 類型的值。

為色彩指定DWMWA_COLOR_DEFAULT (值0xFFFFFFFF) ，將會使用 標題 文字色彩的系統預設行為，將視窗重設為 。

從組建 22000 開始，支援此值 Windows 11。
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS
搭配 DwmGetWindowAttribute 使用。 擷取 DWM 在此視窗周圍繪製的外部框線寬度。 值可能會因視窗的 DPI 而有所不同。 pvAttribute 參數指向UINT類型的值。

從組建 22000 開始，支援此值 Windows 11。
DWMWA_SYSTEMBACKDROP_TYPE
搭配 DwmGetWindowAttribute 或 DwmSetWindowAttribute 使用。 擷取或指定視窗的系統繪製底板材質，包括非工作區後方。 pvAttribute 參數指向類型DWM_SYSTEMBACKDROP_TYPE的值。

從組建 22621 開始，支援此值 Windows 11。
DWMWA_LAST
用於驗證用途的最大可辨識 DWMWINDOWATTRIBUTE 值。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 dwmapi.h

另請參閱