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 |