Fluent-Qt

Referencia de API

FluentElement

Proporciona tokens de diseño Fluent compartidos y devoluciones de llamada de tema a componentes basados en QWidget.

fluent::FluentElement

Enumeraciones

enum Theme

Tema visual global usado al resolver los tokens de diseño.

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

Métodos

static void setTheme(Theme theme)

Actualiza el tema global y notifica a las instancias activas de FluentElement.

static void setThemeDeferred(Theme theme)

Programa una actualización de tema por lotes dando prioridad a lo visible sin bloquear la interacción actual.

static Theme currentTheme()

Devuelve el tema global activo actualmente.

static bool themeUsesDarkAppearance(Theme theme)

Devuelve si un tema utiliza cromo sobre fondo oscuro y tokens de material.

static void refreshTheme()

Vuelve a difundir el tema actual para repintar tras un cambio de token de diseño.

static int themeGeneration()

Contador monótono incrementado en cada cambio de tema para comprobaciones de obsolescencia.

Theme effectiveTheme() const

Resuelve el tema usado por este elemento, respetando una invalidación heredada de QWidget.

bool effectiveThemeUsesDarkAppearance() const

Devuelve si el tema efectivo de este elemento usa cromo sobre fondo oscuro.

bool setThemeOverrides(const QJsonObject& overrides)

Reemplaza las invalidaciones dispersas de tokens de color, radio y fuente de este elemento.

QJsonObject themeOverrides() const

Devuelve las anulaciones definidas en este elemento.

void clearThemeOverrides()

Restaura todos los campos de token a los valores predeterminados del tema global.

const Colors& themeColorsRef() const

Acceso sin copia al conjunto de colores activo para rutas críticas de pintado.

Material::AcrylicToken themeAcrylic() const

Tokens de material, elevación y diseño adaptable.

QColor themeBackdrop(bool active) const

Color de fondo del chrome de la ventana para el estado de activación indicado.

virtual void onThemeUpdated()

Se llama después de que cambia el tema global.

Tipos y alias

struct Colors

Instantáneas de tokens de diseño devueltas a los componentes.

Miembros protegidos

Constructores

Destructores

Campos

FluentElementPrivate* d_ptr

Reservado para compatibilidad de código fuente 1.x.

fluent::FluentElement::Colors

Instantáneas de tokens de diseño devueltas a los componentes.

Campos

QColor strokeFocusOuter, strokeFocusInner

Trazos de doble capa del anillo de enfoque.

QColor textOnAccent

Texto sobre fondos de énfasis (blanco/negro).

QColor textAccentPrimary

Texto de énfasis sobre fondos lisos (azul oscuro/claro).

QColor systemCritical, systemCriticalBg

Colores del sistema / semánticos

QColor bgLayerOverlay

máscara de contenido en capas para ventanas translúcidas.

fluent::FluentElement::FontStyle

Campos

QString styleName

Estilo estático exacto, p. ej., "Regular" o "Semibold".

int lineHeight

Altura de línea absoluta en px, medida desde Figma.

Métodos

fluent::FluentElement::Radius

Campos

int none

0: esquinas rectas.

int control

4: controles dentro de la página.

int overlay

8: contenedores superpuestos (Dialog, ToolTip, Flyout).

fluent::FluentElement::Spacing

Campos

controlHeight

Alturas estándar de control.

fluent::FluentElement::Animation

Campos