API-Referenz
WindowChromeCompat
Plattformübergreifender Adapter für Fensterrahmen-Verhalten, Hit-Testing und Systemhintergründe.
Keine passenden API-Elemente.
compatibility::WindowChromeOptions
Optionen für die plattformspezifische Fensterrahmen-Integration.
Felder
QRect titleBarRectZiehbarer Titelleistenbereich in fensterlokalen Koordinaten.
QVector<QRect> dragExclusionRectsRechtecke untergeordneter Steuerelemente in der Titelleiste, die normaler Client-Bereich bleiben.
int resizeBorderWidth = 8Breite des Treffertest-Rands für Größenänderungen in geräteunabhängigen Pixeln.
bool useCustomWindowChrome = falseAktiviert die benutzerdefinierte Fluent-Titelleistenintegration und bevorzugt dabei native Fensterverwaltung, sofern unterstützt.
bool preferNativeMacControls = trueBehält native macOS-Ampelschaltflächen bei, sofern verfügbar.
bool chromeInteractive = trueSperrt das Verschieben und Ändern der Fenstergröße bei false (z. B. während ein modales Overlay aktiv ist).
QPointer<QAbstractButton> maximizeButtonSchaltfläche zum Maximieren/Wiederherstellen für native Titelleisten-Treffertests.
compatibility::WindowChromeCompat
Konstruktoren
Enumerationen
enum class PlatformLaufzeit-Plattformfamilie für Entscheidungen zur Fenster-Chrome-Richtlinie.
WindowsMacOSLinuxOther
enum class HitTestLogisches Treffertest-Ergebnis, das auf plattformspezifische Treffercodes abgebildet wird.
ClientCaptionLeftRightTopBottomTopLeftTopRightBottomLeftBottomRight
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() constOb diese Plattform einen lichtdurchlässigen Systemhintergrund unterstützt.
BackdropCapabilities backdropCapabilities() constGibt 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 requestForegroundActivation()Fordert die Vordergrundaktivierung über den Fenstermanager der Plattform an.
HitTest hitTestLocal(const QPoint& localPos) constKlassifiziert einen lokalen Punkt anhand der konfigurierten Titelleisten- und Größenänderungsbereiche.
compatibility
Typen und Aliase
using FluentNativeEventResult = qintptrErgebnistyp nativer Ereignisse für QWidget::nativeEvent() über verschiedene Qt-Versionen hinweg.