Fluent-Qt

Référence API

FluentElement

Fournit les jetons de design Fluent partagés et les rappels de thème aux composants basés sur QWidget.

fluent::FluentElement

Énumérations

enum Theme

Thème visuel global utilisé lors de la résolution des tokens de design.

  • Light = 0
  • Dark = 1
  • HighContrast = 2

Méthodes

static void setTheme(Theme theme)

Met à jour le thème global et notifie les instances FluentElement actives.

static void setThemeDeferred(Theme theme)

Planifie une actualisation par lots du thème en donnant la priorité aux éléments visibles sans bloquer l'interaction en cours.

static Theme currentTheme()

Retourne le thème global actuellement actif.

static bool themeUsesDarkAppearance(Theme theme)

Indique si un thème utilise un habillage à fond sombre et des jetons de matériau.

static void refreshTheme()

Rediffuse le thème actuel pour redessiner après une modification de jeton de design.

static int themeGeneration()

Compteur monotone incrémenté à chaque changement de thème pour la vérification d'obsolescence.

Theme effectiveTheme() const

Résout le thème utilisé par cet élément, en respectant une surcharge héritée de QWidget.

bool effectiveThemeUsesDarkAppearance() const

Indique si le thème effectif de cet élément utilise un habillage à fond sombre.

bool setThemeOverrides(const QJsonObject& overrides)

Remplace les surcharges éparses de jetons de couleur, de rayon et de police de cet élément.

QJsonObject themeOverrides() const

Renvoie les surcharges définies pour cet élément.

void clearThemeOverrides()

Restaure tous les champs de tokens aux valeurs par défaut du thème global.

const Colors& themeColorsRef() const

Accès sans copie au jeu de couleurs actif pour les chemins de peinture critiques.

Material::AcrylicToken themeAcrylic() const

Jetons de matériau, d'élévation et de mise en page adaptative.

QColor themeBackdrop(bool active) const

Couleur d'arrière-plan du chrome de fenêtre pour l'état d'activation donné.

virtual void onThemeUpdated()

Appelé après un changement du thème global.

Types et alias

struct Colors

Instantanés de tokens de design renvoyés aux composants.

Membres protégés

Constructeurs

Destructeurs

Champs

FluentElementPrivate* d_ptr

Réservé pour la compatibilité source 1.x.

fluent::FluentElement::Colors

Instantanés de tokens de design renvoyés aux composants.

Champs

QColor strokeFocusOuter, strokeFocusInner

Contours à double couche de l'anneau de focus.

QColor textOnAccent

Texte sur arrière-plan d'accentuation (blanc/noir).

QColor textAccentPrimary

Texte d'accentuation sur arrière-plan uni (bleu foncé/clair).

QColor systemCritical, systemCriticalBg

Couleurs système / sémantiques

QColor bgLayerOverlay

masque de contenu en couches pour fenêtres translucides.

fluent::FluentElement::FontStyle

Champs

QString styleName

Style statique exact, par ex. "Regular" ou "Semibold".

int lineHeight

Hauteur de ligne absolue en px, mesurée dans Figma.

Méthodes

fluent::FluentElement::Radius

Champs

int none

0 : coins carrés.

int control

4 : contrôles dans la page.

int overlay

8 : conteneurs de superposition (Dialog, ToolTip, Flyout).

fluent::FluentElement::Spacing

Champs

controlHeight

Hauteurs standard des contrôles.

fluent::FluentElement::Animation

Champs