Fluent-Qt

API-Referenz

FluentElement

Stellt QWidget-basierten Komponenten gemeinsame Fluent-Design-Tokens und Theme-Callbacks bereit.

fluent::FluentElement

Enumerationen

enum Theme

Globales visuelles Theme zum Auflösen von Design-Tokens.

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

Methoden

static void setTheme(Theme theme)

Aktualisiert das globale Theme und benachrichtigt aktive FluentElement-Instanzen.

static void setThemeDeferred(Theme theme)

Plant eine gebündelte Theme-Aktualisierung mit Priorität für sichtbare Elemente, ohne die aktuelle Interaktion zu blockieren.

static Theme currentTheme()

Gibt das aktuell aktive globale Design zurück.

static bool themeUsesDarkAppearance(Theme theme)

Gibt zurück, ob ein Theme Chrome und Material-Tokens auf dunklem Hintergrund verwendet.

static void refreshTheme()

Sendet das aktuelle Theme nach einer Änderung von Design-Tokens erneut, um ein Neuzeichnen auszulösen.

static int themeGeneration()

Monotoner Zähler zur Veraltungsprüfung, der bei jedem Designwechsel erhöht wird.

Theme effectiveTheme() const

Löst das von diesem Element verwendete Theme auf und berücksichtigt dabei eine geerbte QWidget-Überschreibung.

bool effectiveThemeUsesDarkAppearance() const

Gibt zurück, ob das effektive Theme dieses Elements Chrome auf dunklem Hintergrund verwendet.

bool setThemeOverrides(const QJsonObject& overrides)

Ersetzt die selektiven Farb-, Radius- und Schrift-Token-Überschreibungen dieses Elements.

QJsonObject themeOverrides() const

Gibt die festgelegten Überschreibungen dieses Elements zurück.

void clearThemeOverrides()

Setzt alle Token-Felder auf die Standardwerte des globalen Designs zurück.

const Colors& themeColorsRef() const

Kopiefreier Zugriff auf das aktive Farbset für kritische Zeichenpfade.

Material::AcrylicToken themeAcrylic() const

Material-, Höhenstufen- und adaptive Layout-Tokens.

QColor themeBackdrop(bool active) const

Backdrop-Farbe des Fenster-Chrome für den angegebenen Aktivierungszustand.

virtual void onThemeUpdated()

Wird nach einer Änderung des globalen Themes aufgerufen.

Typen und Aliase

struct Colors

An Komponenten zurückgegebene Design-Token-Snapshots.

Geschützte Elemente

Konstruktoren

Destruktoren

Felder

FluentElementPrivate* d_ptr

Für die 1.x-Quellcodekompatibilität reserviert.

fluent::FluentElement::Colors

An Komponenten zurückgegebene Design-Token-Snapshots.

Felder

QColor strokeFocusOuter, strokeFocusInner

Zweilagige Fokusring-Konturen.

QColor textOnAccent

Text auf Akzenthintergründen (Weiß/Schwarz).

QColor textAccentPrimary

Akzenttext auf schlichten Hintergründen (Dunkel-/Hellblau).

QColor bgCanvas, bgLayer, bgLayerAlt, bgSolid

Hintergründe & Neutrale Farben

QColor systemCritical, systemCriticalBg

System- / Semantische Farben

QColor bgLayerOverlay

Mehrschichtige Inhaltsmaske für halbtransparente Fenster.

fluent::FluentElement::FontStyle

Felder

QString styleName

Exakter statischer Schriftschnitt, z. B. "Regular" oder "Semibold".

int lineHeight

Absolute Zeilenhöhe in px, aus Figma gemessen.

Methoden

fluent::FluentElement::Radius

Felder

int none

0: rechtwinklige Ecken.

int control

4: Steuerelemente innerhalb der Seite.

int overlay

8: Overlay-Container (Dialog, ToolTip, Flyout).

fluent::FluentElement::Spacing

Felder

controlHeight

Standardhöhen für Steuerelemente.

fluent::FluentElement::Animation

Felder