基础输入

RangeSlider 区间滑块

拖动两个手柄选择下限和上限。

示例

用法

实时显示区间

setRange() 设置范围，setValues() 同时设置下限和上限；拖动时 valuesChanged 给出当前区间。

#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

查看声明

`fluent::basicinput::RangeSlider`

继承自 QWidget · FluentElement · QMLPlus

选择下限值与上限值的 Fluent 双手柄滑块。

构造函数

explicit RangeSlider(Qt::Orientation orientation = Qt::Horizontal, QWidget* parent = nullptr)
explicit RangeSlider(QWidget* parent)

属性

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()