API 參考
WindowChromeCompat
視窗標題列行為、點擊測試與系統背景的跨平台配接器。
沒有符合的 API 成員。
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用於決定視窗外框原則的執行階段平台系列。
WindowsMacOSLinuxOther
enum class HitTest對應至平台專屬點擊代碼的邏輯點擊測試結果。
ClientCaptionLeftRightTopBottomTopLeftTopRightBottomLeftBottomRight
方法
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 handleNativeEvent(const QByteArray& eventType, void* message, FluentNativeEventResult* result)處理轉發的原生事件;若已處理則傳回 true。
bool beginSystemMove(const QPoint& globalPos)啟動平台系統視窗移動操作。
bool beginSystemResize(Qt::Edges edges, const QPoint& globalPos)針對指定邊緣啟動平台系統視窗調整大小操作。
bool performTitleBarDoubleClick()執行平台預設的標題列連按兩下動作。
bool requestForegroundActivation()透過平台視窗管理員請求前景啟用。
HitTest hitTestLocal(const QPoint& localPos) const根據設定的標題列與調整大小區域,對本地座標點進行分類。
compatibility
型別與別名
using FluentNativeEventResult = qintptr跨 Qt 版本供 QWidget::nativeEvent() 使用的原生事件結果類型。