Fluent-Qt

Базовый ввод

RangeSlider Ползунок диапазона

Перетаскивайте два бегунка вдоль шкалы для выбора нижней и верхней границ.

Пример

RangeSlider Ползунок диапазона: Текущие значения ползунка диапазона

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

Текущие значения ползунка диапазона

Задайте границы через setRange() и обе конечные точки через setValues(); valuesChanged отправляет активный интервал при перетаскивании (минимальный зазор 0 позволяет бегункам сходиться). Деления появляются при наведении вдоль стороны шкалы.

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

auto* layout = new QVBoxLayout(this);
layout->setContentsMargins(0, 0, 0, 0);
layout->setSpacing(8);
auto* slider = new RangeSlider(Qt::Horizontal, this);
slider->setAccessibleName("Price range");
slider->setRange(0, 100);
slider->setValues(20, 64);
slider->setMaximumWidth(260);
auto* status = new Label("Range: 20 to 64", this);
layout->addWidget(slider);
layout->addWidget(status);
connect(slider, &RangeSlider::valuesChanged,
        status, [status](int lower, int upper) {
            status->setText(QString("Range: %1 to %2").arg(lower).arg(upper));
        });

fluent::basicinput::RangeSlider

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

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

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

Деструкторы

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

enum class Thumb

Идентифицирует один из двух бегунков.

  • Lower
  • Upper

Методы

Qt::Orientation orientation() const

Ориентация дорожки; у вертикальных ползунков минимум находится внизу.

void setOrientation(Qt::Orientation orientation)

Ориентация дорожки; у вертикальных ползунков минимум находится внизу.

int minimum() const

Наименьшее выбираемое значение.

void setMinimum(int minimum)

Наименьшее выбираемое значение.

int maximum() const

Наибольшее выбираемое значение.

void setMaximum(int maximum)

Наибольшее выбираемое значение.

void setRange(int minimum, int maximum)

Задаёт обе границы; максимум меньше минимума приравнивается к минимуму.

int lowerValue() const

Зафиксированное нижнее значение.

void setLowerValue(int value)

Зафиксированное нижнее значение.

int upperValue() const

Зафиксированное верхнее значение.

void setUpperValue(int value)

Зафиксированное верхнее значение.

void setValues(int lower, int upper)

Задаёт оба значения сразу, упорядочивая их и применяя minimumRange.

int lowerPosition() const

Визуальная нижняя позиция; отличается от lowerValue только при перетаскивании без tracking.

int upperPosition() const

Визуальная верхняя позиция; отличается от upperValue только при перетаскивании без tracking.

int minimumRange() const

Наименьшее допустимое расстояние между двумя значениями; 0 позволяет бегункам соприкасаться.

void setMinimumRange(int range)

Наименьшее допустимое расстояние между двумя значениями; 0 позволяет бегункам соприкасаться.

int singleStep() const

Шаг клавиш со стрелками.

void setSingleStep(int step)

Шаг клавиш со стрелками.

int pageStep() const

Шаг клавиш Page Up и Page Down.

void setPageStep(int step)

Шаг клавиш Page Up и Page Down.

QSlider::TickPosition tickPosition() const

Расположение делений; деления отображаются при наведении указателя на элемент управления.

void setTickPosition(QSlider::TickPosition position)

Расположение делений; деления отображаются при наведении указателя на элемент управления.

int tickInterval() const

Шаг делений в единицах значения; 0 вычисляет его из шага, как в QSlider.

void setTickInterval(int interval)

Шаг делений в единицах значения; 0 вычисляет его из шага, как в QSlider.

bool hasTracking() const

Фиксируются ли значения при перетаскивании; при false — только при отпускании.

void setTracking(bool enabled)

Фиксируются ли значения при перетаскивании; при false — только при отпускании.

Thumb activeThumb() const

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

void setActiveThumb(Thumb thumb)

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

bool isSliderDown() const

Определяет, перетаскивается ли ползунок.

QPoint thumbCenter(Thumb thumb) const

Центр ползунка в координатах виджета для компоновки и специальных возможностей.

Свойства

Qt::Orientation orientation

Ориентация дорожки; у вертикальных ползунков минимум находится внизу.

Чтение orientation()Запись setOrientation()Уведомление orientationChanged()
int minimum

Наименьшее выбираемое значение.

Чтение minimum()Запись setMinimum()Уведомление rangeChanged()
int maximum

Наибольшее выбираемое значение.

Чтение maximum()Запись setMaximum()Уведомление rangeChanged()
int lowerValue

Зафиксированное нижнее значение.

Чтение lowerValue()Запись setLowerValue()Уведомление lowerValueChanged()
int upperValue

Зафиксированное верхнее значение.

Чтение upperValue()Запись setUpperValue()Уведомление upperValueChanged()
int minimumRange

Наименьшее допустимое расстояние между двумя значениями; 0 позволяет бегункам соприкасаться.

Чтение minimumRange()Запись setMinimumRange()Уведомление minimumRangeChanged()
int singleStep

Шаг клавиш со стрелками.

Чтение singleStep()Запись setSingleStep()Уведомление singleStepChanged()
int pageStep

Шаг клавиш Page Up и Page Down.

Чтение pageStep()Запись setPageStep()Уведомление pageStepChanged()
QSlider::TickPosition tickPosition

Расположение делений; деления отображаются при наведении указателя на элемент управления.

Чтение tickPosition()Запись setTickPosition()Уведомление tickPositionChanged()
int tickInterval

Шаг делений в единицах значения; 0 вычисляет его из шага, как в QSlider.

Чтение tickInterval()Запись setTickInterval()Уведомление tickIntervalChanged()
bool tracking

Фиксируются ли значения при перетаскивании; при false — только при отпускании.

Чтение hasTracking()Запись setTracking()Уведомление trackingChanged()
Thumb activeThumb

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

Чтение activeThumb()Запись setActiveThumb()Уведомление activeThumbChanged()

Сигналы

void orientationChanged(Qt::Orientation orientation)

Ориентация дорожки; у вертикальных ползунков минимум находится внизу.

void rangeChanged(int minimum, int maximum)

Наименьшее выбираемое значение.

void lowerValueChanged(int value)

Зафиксированное нижнее значение.

void upperValueChanged(int value)

Зафиксированное верхнее значение.

void valuesChanged(int lower, int upper)

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

void minimumRangeChanged(int range)

Наименьшее допустимое расстояние между двумя значениями; 0 позволяет бегункам соприкасаться.

void singleStepChanged(int step)

Шаг клавиш со стрелками.

void pageStepChanged(int step)

Шаг клавиш Page Up и Page Down.

void tickPositionChanged(QSlider::TickPosition position)

Расположение делений; деления отображаются при наведении указателя на элемент управления.

void tickIntervalChanged(int interval)

Шаг делений в единицах значения; 0 вычисляет его из шага, как в QSlider.

void trackingChanged(bool enabled)

Фиксируются ли значения при перетаскивании; при false — только при отпускании.

void activeThumbChanged(Thumb thumb)

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

void sliderPressed()

Испускается, когда нажатие указателя начинает перетаскивание.

void sliderMoved(int lower, int upper)

Испускается при перемещении перетаскиваемой позиции независимо от того, включён ли tracking.

void sliderReleased()

Испускается один раз по завершении перетаскивания, после фиксации итоговых значений.

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

Методы

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