Fluent-Qt

API 參考

WindowChromeCompat

視窗標題列行為、點擊測試與系統背景的跨平台配接器。

compatibility::WindowChromeOptions

平台視窗標題列與邊框整合選項。

欄位

QRect titleBarRect

視窗區域座標中可拖曳的標題列區域。

QVector<QRect> dragExclusionRects

標題列內保持為一般工作區的子控制項矩形區域。

int resizeBorderWidth = 8

調整大小命中測試邊框寬度(以裝置無關像素為單位)。

bool useCustomWindowChrome = false

啟用 Fluent 自訂標題列整合,同時在支援的平台上優先採用原生視窗管理。

bool preferNativeMacControls = true

可用時保留原生 macOS 視窗控制按鈕(紅綠燈)。

bool chromeInteractive = true

為 false 時鎖定視窗移動與調整大小(例如在強制回應覆疊層啟用期間)。

QPointer<QAbstractButton> maximizeButton

用於原生標題列點擊測試的最大化/還原按鈕。

compatibility::WindowChromeCompat

建構函式

列舉

enum class Platform

用於決定視窗外框原則的執行階段平台系列。

  • Windows
  • MacOS
  • Linux
  • Other
enum class HitTest

對應至平台專屬點擊代碼的邏輯點擊測試結果。

  • Client
  • Caption
  • Left
  • Right
  • Top
  • Bottom
  • TopLeft
  • TopRight
  • BottomLeft
  • BottomRight

方法

void configure(const WindowChromeOptions& options)

更新視窗邊框選項並同步平台標題列幾何資訊。

void applyPlatformWindowFlags()

依目前的外框組態套用所需的平台視窗旗標。

bool systemBackdropSupported() const

目前平台是否支援半透明系統背景。

BackdropCapabilities backdropCapabilities() const

傳回目前工作階段各效果的平台支援能力。

bool applySystemBackdrop(BackdropEffect effect, bool dark, bool forceRecomposite = false)

套用所請求的系統背景效果(舊版輔助函式;請使用 applySystemBackdropDetailed() 取得解析後的後端詳細資訊)。

BackdropApplyResult applySystemBackdropDetailed(BackdropEffect effect, bool dark, bool forceRecomposite = false)

套用背景效果並傳回實際解析的後端、還原度及降級原因。

bool beginSystemMove(const QPoint& globalPos)

啟動平台系統視窗移動操作。

bool beginSystemResize(Qt::Edges edges, const QPoint& globalPos)

針對指定邊緣啟動平台系統視窗調整大小操作。

bool performTitleBarDoubleClick()

執行平台預設的標題列連按兩下動作。

bool showSystemMenu(const QPoint& globalPos)

在指定的全域座標處顯示平台系統選單。

bool requestForegroundActivation()

透過平台視窗管理員請求前景啟用。

HitTest hitTestLocal(const QPoint& localPos) const

根據設定的標題列與調整大小區域,對本地座標點進行分類。

compatibility

型別與別名

using FluentNativeEventResult = qintptr

跨 Qt 版本供 QWidget::nativeEvent() 使用的原生事件結果類型。