API-Referenz
FluentElement
Stellt QWidget-basierten Komponenten gemeinsame Fluent-Design-Tokens und Theme-Callbacks bereit.
Keine passenden API-Elemente.
fluent::FluentElement
Enumerationen
enum ThemeGlobales visuelles Theme zum Auflösen von Design-Tokens.
Light = 0Dark = 1HighContrast = 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() constLöst das von diesem Element verwendete Theme auf und berücksichtigt dabei eine geerbte QWidget-Überschreibung.
bool effectiveThemeUsesDarkAppearance() constGibt 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() constGibt die festgelegten Überschreibungen dieses Elements zurück.
void clearThemeOverrides()Setzt alle Token-Felder auf die Standardwerte des globalen Designs zurück.
const Colors& themeColorsRef() constKopiefreier Zugriff auf das aktive Farbset für kritische Zeichenpfade.
Material::AcrylicToken themeAcrylic() constMaterial-, Höhenstufen- und adaptive Layout-Tokens.
QColor themeBackdrop(bool active) constBackdrop-Farbe des Fenster-Chrome für den angegebenen Aktivierungszustand.
virtual void onThemeUpdated()Wird nach einer Änderung des globalen Themes aufgerufen.
Typen und Aliase
struct ColorsAn Komponenten zurückgegebene Design-Token-Snapshots.
Geschützte Elemente
Konstruktoren
Destruktoren
Felder
FluentElementPrivate* d_ptrFür die 1.x-Quellcodekompatibilität reserviert.
fluent::FluentElement::Colors
An Komponenten zurückgegebene Design-Token-Snapshots.
Felder
QColor strokeFocusOuter, strokeFocusInnerZweilagige Fokusring-Konturen.
QColor textOnAccentText auf Akzenthintergründen (Weiß/Schwarz).
QColor textAccentPrimaryAkzenttext auf schlichten Hintergründen (Dunkel-/Hellblau).
QColor bgCanvas, bgLayer, bgLayerAlt, bgSolidHintergründe & Neutrale Farben
QColor systemCritical, systemCriticalBgSystem- / Semantische Farben
QList<QColor> chartsDiagramme
QColor bgLayerOverlayMehrschichtige Inhaltsmaske für halbtransparente Fenster.
fluent::FluentElement::FontStyle
Felder
QString styleNameExakter statischer Schriftschnitt, z. B. "Regular" oder "Semibold".
int lineHeightAbsolute Zeilenhöhe in px, aus Figma gemessen.
Methoden
fluent::FluentElement::Radius
Felder
int none0: rechtwinklige Ecken.
int control4: Steuerelemente innerhalb der Seite.
int overlay8: Overlay-Container (Dialog, ToolTip, Flyout).
fluent::FluentElement::Spacing
Felder
controlHeightStandardhöhen für Steuerelemente.
fluent::FluentElement::Animation
Felder
int fast, normal, slow, verySlowDauern (ms)
QEasingCurve standard, accelerate, decelerate, entrance, exitEasing-Funktionen