Базовый ввод
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));
});import fluentqt
from PySide6.QtCore import Qt
from PySide6.QtWidgets import QVBoxLayout
layout = QVBoxLayout(root)
layout.setContentsMargins(0, 0, 0, 0)
layout.setSpacing(8)
slider = fluentqt.RangeSlider(Qt.Orientation.Horizontal)
slider.setAccessibleName('Price range')
slider.setRange(0, 100)
slider.setValues(20, 64)
slider.setMaximumWidth(260)
status = fluentqt.Label('Range: 20 to 64')
slider.valuesChanged.connect(
lambda lower, upper: status.setText(f"Range: {lower} to {upper}")
)
layout.addWidget(slider)
layout.addWidget(status)API
ОбъявлениеНет подходящих элементов API.
fluent::basicinput::RangeSlider
Наследует QWidget · FluentElement · QMLPlus
Ползунок Fluent с двумя бегунками для выбора нижнего и верхнего значений.
Конструкторы
Деструкторы
Перечисления
enum class ThumbИдентифицирует один из двух бегунков.
LowerUpper
Методы
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 = 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