Fluent-Qt

Справочник API

FluentElement

Предоставляет общие дизайн-токены Fluent и обратные вызовы тем для компонентов на основе QWidget.

fluent::FluentElement

Перечисления

enum Theme

Глобальная визуальная тема, используемая при разрешении дизайн-токенов.

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

Методы

static void setTheme(Theme theme)

Обновляет глобальную тему и уведомляет активные экземпляры FluentElement.

static void setThemeDeferred(Theme theme)

Планирует пакетное обновление темы с приоритетом видимых элементов без блокировки текущего взаимодействия.

static Theme currentTheme()

Возвращает текущую активную глобальную тему.

static bool themeUsesDarkAppearance(Theme theme)

Возвращает, использует ли тема токены тёмного оформления и материалов.

static void refreshTheme()

Повторно рассылает текущую тему для перерисовки после изменения дизайн-токенов.

static int themeGeneration()

Монотонный счётчик, увеличиваемый при каждом изменении темы для проверки актуальности.

Theme effectiveTheme() const

Определяет тему, используемую этим элементом, с учётом унаследованного переопределения QWidget.

bool effectiveThemeUsesDarkAppearance() const

Возвращает, использует ли действующая тема этого элемента тёмную основу оформления.

bool setThemeOverrides(const QJsonObject& overrides)

Заменяет разреженные переопределения токенов цвета, скругления и шрифта этого элемента.

QJsonObject themeOverrides() const

Возвращает заданные переопределения этого элемента.

void clearThemeOverrides()

Восстанавливает для всех полей токенов значения глобальной темы по умолчанию.

const Colors& themeColorsRef() const

Доступ без копирования к активному набору цветов для горячих путей отрисовки.

Material::AcrylicToken themeAcrylic() const

Токены материалов, возвышения и адаптивной компоновки.

QColor themeBackdrop(bool active) const

Цвет фона рамки окна для заданного состояния активации.

virtual void onThemeUpdated()

Вызывается после изменения глобальной темы.

Типы и псевдонимы

struct Colors

Снимки дизайн-токенов, возвращаемые компонентам.

Защищённые члены

Конструкторы

Деструкторы

Поля

FluentElementPrivate* d_ptr

Зарезервировано для совместимости исходного кода с 1.x.

fluent::FluentElement::Colors

Снимки дизайн-токенов, возвращаемые компонентам.

Поля

QColor strokeFocusOuter, strokeFocusInner

Двухслойная обводка кольца фокуса.

QColor textOnAccent

Текст на акцентном фоне (белый/чёрный).

QColor textAccentPrimary

Акцентный текст на обычном фоне (тёмно-/светло-синий).

QColor bgCanvas, bgLayer, bgLayerAlt, bgSolid

Фоны и нейтральные цвета

QColor systemCritical, systemCriticalBg

Системные / семантические цвета

QList<QColor> charts

Диаграммы

QColor bgLayerOverlay

маска многослойного содержимого для полупрозрачных окон.

fluent::FluentElement::FontStyle

Поля

QString styleName

Точное статическое начертание, например "Regular" или "Semibold".

int lineHeight

Абсолютная высота строки в px по замерам из Figma.

Методы

fluent::FluentElement::Radius

Поля

int none

0: прямые углы.

int control

4: элементы управления на странице.

int overlay

8: контейнеры наложения (Dialog, ToolTip, Flyout).

fluent::FluentElement::Spacing

Поля

controlHeight

Стандартные высоты элементов управления.

fluent::FluentElement::Animation

Поля

int fast, normal, slow, verySlow

Длительности (мс)