Базовый ввод
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");
});import fluentqt
toggle = fluentqt.ToggleSwitch()
toggle.setOnContent("On")
toggle.setOffContent("Off")
toggle.setAccessibleName("Feature toggle")
status = fluentqt.Label("State: Off")
toggle.toggled.connect(
lambda on: status.setText("State: On" if on else "State: Off")
)API
ОбъявлениеНет подходящих элементов API.
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 = 0Dark = 1HighContrast = 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 bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Устанавливает управляемую прямую привязку на этом хосте QWidget.
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