Fluent-Qt

API-Referenz

WindowChromeCompat

Plattformübergreifender Adapter für Fensterrahmen-Verhalten, Hit-Testing und Systemhintergründe.

compatibility::WindowChromeOptions

Optionen für die plattformspezifische Fensterrahmen-Integration.

Felder

QRect titleBarRect

Ziehbarer Titelleistenbereich in fensterlokalen Koordinaten.

QVector<QRect> dragExclusionRects

Rechtecke untergeordneter Steuerelemente in der Titelleiste, die normaler Client-Bereich bleiben.

int resizeBorderWidth = 8

Breite des Treffertest-Rands für Größenänderungen in geräteunabhängigen Pixeln.

bool useCustomWindowChrome = false

Aktiviert die benutzerdefinierte Fluent-Titelleistenintegration und bevorzugt dabei native Fensterverwaltung, sofern unterstützt.

bool preferNativeMacControls = true

Behält native macOS-Ampelschaltflächen bei, sofern verfügbar.

bool chromeInteractive = true

Sperrt das Verschieben und Ändern der Fenstergröße bei false (z. B. während ein modales Overlay aktiv ist).

QPointer<QAbstractButton> maximizeButton

Schaltfläche zum Maximieren/Wiederherstellen für native Titelleisten-Treffertests.

compatibility::WindowChromeCompat

Konstruktoren

Enumerationen

enum class Platform

Laufzeit-Plattformfamilie für Entscheidungen zur Fenster-Chrome-Richtlinie.

  • Windows
  • MacOS
  • Linux
  • Other
enum class HitTest

Logisches Treffertest-Ergebnis, das auf plattformspezifische Treffercodes abgebildet wird.

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

Methoden

void configure(const WindowChromeOptions& options)

Aktualisiert die Fensterrahmen-Optionen und synchronisiert die Geometrie der plattformseitigen Titelleiste.

void applyPlatformWindowFlags()

Wendet die für die aktuelle Fensterrahmen-Konfiguration erforderlichen Plattform-Fensterflags an.

bool systemBackdropSupported() const

Ob diese Plattform einen lichtdurchlässigen Systemhintergrund unterstützt.

BackdropCapabilities backdropCapabilities() const

Gibt die Plattformfunktionen pro Effekt für die aktuelle Sitzung zurück.

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

Wendet den angeforderten System-Hintergrundeffekt an (veralteter Helfer; verwenden Sie applySystemBackdropDetailed() für aufgelöste Backend-Details).

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

Wendet einen Hintergrundeffekt an und gibt das aufgelöste Backend, die Wiedergabetreue und den Fallback-Grund zurück.

bool handleNativeEvent(const QByteArray& eventType, void* message, FluentNativeEventResult* result)

Verarbeitet weitergeleitete native Ereignisse und gibt true zurück, wenn sie behandelt wurden.

bool beginSystemMove(const QPoint& globalPos)

Startet einen plattformspezifischen System-Verschiebevorgang.

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

Startet einen plattformspezifischen System-Größenänderungsvorgang für die angegebenen Kanten.

bool performTitleBarDoubleClick()

Führt die plattformübliche Doppelklick-Aktion der Titelleiste aus.

bool showSystemMenu(const QPoint& globalPos)

Zeigt das plattformspezifische Systemmenü an der angegebenen globalen Position an.

bool requestForegroundActivation()

Fordert die Vordergrundaktivierung über den Fenstermanager der Plattform an.

HitTest hitTestLocal(const QPoint& localPos) const

Klassifiziert einen lokalen Punkt anhand der konfigurierten Titelleisten- und Größenänderungsbereiche.

compatibility

Typen und Aliase

using FluentNativeEventResult = qintptr

Ergebnistyp nativer Ereignisse für QWidget::nativeEvent() über verschiedene Qt-Versionen hinweg.