Fluent-Qt

Базовый ввод

ToggleSwitch Переключатель

Переключатель между состояниями «включено» и «выключено».

Пример

ToggleSwitch Переключатель: Состояние ToggleSwitch

Использование

Состояние ToggleSwitch

Сигнал toggled отражает состояние включения/выключения в окружающем интерфейсе.

#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;

auto* toggle = new ToggleSwitch(this);
toggle->setOnContent("On");
toggle->setOffContent("Off");
toggle->setAccessibleName("Feature toggle");
auto* status = new Label("State: Off", this);
connect(toggle, &ToggleSwitch::toggled,
        status, [status](bool on) {
            status->setText(on ? "State: On" : "State: Off");
        });

fluent::basicinput::ToggleSwitch

Наследует QWidget · FluentElement · QMLPlus

Переключатель Fluent (вкл./выкл.). Отрисовывает только дорожку, бегунок и опциональный текст состояния; метки поля размещайте снаружи (например, с помощью Field).

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

Методы

bool isOn() const

Текущее состояние переключателя (вкл./выкл.).

void setIsOn(bool on)

Текущее состояние переключателя (вкл./выкл.).

QString onContent() const

Текст для включённого состояния.

void setOnContent(const QString& content)

Текст для включённого состояния.

QString offContent() const

Текст для выключенного состояния.

void setOffContent(const QString& content)

Текст для выключенного состояния.

Typography::FontRole fontRole() const

Пресет Fluent Typography, используемый при следовании шрифтам темы.

void setFontRole(Typography::FontRole role)

Пресет Fluent Typography, используемый при следовании шрифтам темы.

qreal visualScale() const

Масштаб графики переключателя и отступа содержимого, не зависящий от размера виджета и шрифта.

void setVisualScale(qreal scale)

Задаёт визуальный масштаб переключателя (ограничивается [0.5, 10.0], по умолчанию 1.0 = 40x20 px) без изменения размеров фиксированных виджетов или текста.

void setFont(const QFont& font)

Задаёт явный шрифт, который не меняется при последующих обновлениях темы.

qreal knobPosition() const

Анимированная позиция бегунка переключателя, нормализованная от выкл. к вкл.

void setKnobPosition(qreal pos)

Анимированная позиция бегунка переключателя, нормализованная от выкл. к вкл.

Свойства

bool isOn

Текущее состояние переключателя (вкл./выкл.).

Чтение isOn()Запись setIsOn()Уведомление toggled()
QString onContent

Текст для включённого состояния.

Чтение onContent()Запись setOnContent()Уведомление onContentChanged()
QString offContent

Текст для выключенного состояния.

Чтение offContent()Запись setOffContent()Уведомление offContentChanged()
Typography::FontRole fontRole

Пресет Fluent Typography, используемый при следовании шрифтам темы.

Чтение fontRole()Запись setFontRole()Уведомление fontRoleChanged()
qreal visualScale

Масштаб графики переключателя и отступа содержимого, не зависящий от размера виджета и шрифта.

Чтение visualScale()Запись setVisualScale()Уведомление visualScaleChanged()
qreal knobPosition

Анимированная позиция бегунка переключателя, нормализованная от выкл. к вкл.

Чтение knobPosition()Запись setKnobPosition()

Сигналы

void toggled(bool isOn)

Текущее состояние переключателя (вкл./выкл.).

void onContentChanged(const QString& content)

Текст для включённого состояния.

void offContentChanged(const QString& content)

Текст для выключенного состояния.

void fontRoleChanged()

Пресет Fluent Typography, используемый при следовании шрифтам темы.

void visualScaleChanged(qreal scale)

Масштаб графики переключателя и отступа содержимого, не зависящий от размера виджета и шрифта.

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

Методы

Унаследовано от 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

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

Унаследовано от fluent::QMLPlus

Методы

AnchorLayout::Anchors* anchors()

Возвращает изменяемые привязки для хоста QWidget.

void setState(const QString& name)

Применяет зарегистрированное состояние по имени или восстанавливает состояние по умолчанию, если @p name пусто. Неизвестные имена игнорируются, а при выходе из состояния возобновляются прежние привязки.

void addState(const QMLState& state)

Регистрирует или заменяет именованное определение состояния; замена активного состояния применяется немедленно.

void evaluateStates()

Повторно вычисляет условия состояний в порядке регистрации и активирует первое совпадение или состояние по умолчанию, если совпадений нет. Также выполняется автоматически при уведомлениях свойств-зависимостей; производные состояния с extend наследуют изменения предков, если нет циклов или пропусков.

QMLPlusRuntime* runtime()

Возвращает лениво создаваемый наблюдатель состояния, принадлежащий этому хосту.

void setAnchors(const AnchorLayout::Anchors& anchors)

Заменяет все привязки хоста и инвалидирует родительскую компоновку.

void resetAnchors()

Очищает все привязки хоста и делает родительский макет недействительным.

void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)

Связывает @p sourceProp объекта @p source со свойством @p targetProp этого хоста QWidget через PropertyBinder::bind().

BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})

Устанавливает C++-выражение с явными зависимостями на этом хосте QWidget.

void addTransition(const StateTransition& transition)

Регистрирует переход состояния в порядке приоритета.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

Задаёт анимацию по умолчанию при записи @p propertyName через writeProperty() или привязку. Явные правила StateTransition имеют приоритет; прямые вызовы C++ сеттеров не анимируются.

void clearBehavior(const char* propertyName)

Удаляет анимацию по умолчанию для последующих управляемых записей.

bool writeProperty(const char* propertyName, const QVariant& value)

Записывает свойство хоста через Behavior без удаления его привязки.

Документация базового класса Qt: QWidget