共用方式為


DWMWINDOWATTRIBUTE 列舉 (dwmapi.h)

DwmGetWindowAttributeDwmSetWindowAttribute 函式所使用的選項。

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_BITMAPDWMWA_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
搭配 DwmGetWindowAttributeDwmSetWindowAttribute 使用。 擷取或指定視窗的系統繪製底板材質,包括非工作區後方。 pvAttribute 參數指向類型DWM_SYSTEMBACKDROP_TYPE的值。

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

規格需求

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

另請參閱