Fluent-Qt

Référence API

WindowChromeCompat

Adaptateur multiplateforme pour l'habillage de fenêtre, le hit-testing et les arrière-plans système.

compatibility::WindowChromeOptions

Options d'intégration des bordures et de la barre de titre de la plateforme.

Champs

QRect titleBarRect

Zone de barre de titre déplaçable en coordonnées locales de la fenêtre.

QVector<QRect> dragExclusionRects

Rectangles des contrôles enfants dans la barre de titre qui restent une zone client normale.

int resizeBorderWidth = 8

Largeur de bordure pour le test de collision de redimensionnement en pixels indépendants du périphérique.

bool useCustomWindowChrome = false

Active l'intégration de la barre de titre personnalisée Fluent tout en privilégiant la gestion native des fenêtres lorsqu'elle est prise en charge.

bool preferNativeMacControls = true

Conserve les boutons tricolores natifs macOS lorsqu'ils sont disponibles.

bool chromeInteractive = true

Verrouille le déplacement et le redimensionnement de la fenêtre lorsque false (par ex. lorsqu'une superposition modale est active).

QPointer<QAbstractButton> maximizeButton

Bouton agrandir/restaurer utilisé pour les tests de clic de la barre de titre native.

compatibility::WindowChromeCompat

Constructeurs

Énumérations

enum class Platform

Famille de plateformes d'exécution utilisée pour les décisions de stratégie d'habillage de fenêtre.

  • Windows
  • MacOS
  • Linux
  • Other
enum class HitTest

Résultat logique de test de clic mappé vers les codes spécifiques à la plateforme.

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

Méthodes

void configure(const WindowChromeOptions& options)

Met à jour les options de contour de fenêtre et synchronise la géométrie de la barre de titre plateforme.

void applyPlatformWindowFlags()

Applique les indicateurs de fenêtre de plateforme requis par la configuration d'habillage actuelle.

bool systemBackdropSupported() const

Indique si cette plateforme prend en charge un arrière-plan système translucide.

BackdropCapabilities backdropCapabilities() const

Retourne les capacités de la plateforme par effet pour la session active.

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

Applique l'effet d'arrière-plan système demandé (assistant obsolète ; utilisez applySystemBackdropDetailed() pour obtenir les détails du backend résolu).

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

Applique un effet d'arrière-plan et retourne le backend résolu, le niveau de fidélité et le motif de repli.

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

Gère les événements natifs transmis et renvoie true lorsqu'ils sont traités.

bool beginSystemMove(const QPoint& globalPos)

Démarre une opération de déplacement système de la plateforme.

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

Démarre une opération de redimensionnement système de la plateforme pour les bords donnés.

bool performTitleBarDoubleClick()

Exécute l'action par défaut de double-clic sur la barre de titre de la plateforme.

bool showSystemMenu(const QPoint& globalPos)

Affiche le menu système de la plateforme à la position globale donnée.

bool requestForegroundActivation()

Demande l'activation au premier plan via le gestionnaire de fenêtres de la plateforme.

HitTest hitTestLocal(const QPoint& localPos) const

Classe un point local par rapport aux zones configurées de barre de titre et de redimensionnement.

compatibility

Types et alias

using FluentNativeEventResult = qintptr

Type de résultat d'événement natif utilisé par QWidget::nativeEvent() entre les versions de Qt.