桌面应用 / 系统课时

用数值控件输入范围数据

用数值控件输入范围数据

当输入必须落在明确范围内时,让用户自由填写文本会增加校验成本。Qt 6 提供 QSpinBox、QDoubleSpinBox 和 QSlider,分别适合整数、小数和快速拖动选择。本节用一个完整窗口演示范围、步长、显示格式与取值方式。

学习目标

  • 根据整数、小数和拖动选择场景选择合适的数值控件。
  • 使用范围、步长、小数位和单位后缀约束输入。
  • 通过 value() 与 valueChanged 获取已经过控件约束的数值。

先选对数值控件

三个控件都能限制输入范围,但交互方式不同。QSpinBox 保存整数,适合线程数、重试次数这类离散值;QDoubleSpinBox 保存 double,适合比例、价格或阈值;QSlider 的内部值仍是整数,更适合用户快速拖动选择相对位置。

控件 值类型 典型场景 关键设置
QSpinBox int 数量、次数、页码 setRange()、setSingleStep()
QDoubleSpinBox double 比例、金额、精度参数 setRange()、setDecimals()、setSingleStep()
QSlider int 音量、亮度、进度位置 setRange()、setValue()、方向

如果业务值本身是小数,不要直接假设 QSlider 能保存浮点数。常见做法是把滑块位置按比例映射到小数,或者用滑块负责快速调节、用 QDoubleSpinBox 显示并精确编辑。

配置范围、步长与显示格式

数值控件最重要的不是“能输入数字”,而是把业务约束直接放进控件。范围决定合法边界,步长决定按钮或键盘每次变化多少,前后缀则负责把单位显示给用户。

例如线程数可以限制为 1~16,并以 1 为步长;播放速度可以限制为 0.5~3.0,保留 1 位小数并以 0.1 为步长。这样读取 value() 时,得到的是控件已经约束后的值,不需要再从字符串解析数字。

完整示例

下面的 main.cpp 可放入一个已链接 Qt6::Widgets 的 Qt Widgets 工程。窗口同时创建整数输入、小数输入和水平滑块,并实时显示滑块当前值。

cpp
#include <QApplication>
#include <QDoubleSpinBox>
#include <QFormLayout>
#include <QLabel>
#include <QSlider>
#include <QSpinBox>
#include <QWidget>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QWidget window;
    window.setWindowTitle("数值输入");

    auto *layout = new QFormLayout(&window);

    auto *threads = new QSpinBox(&window);
    threads->setRange(1, 16);
    threads->setSingleStep(1);
    threads->setValue(4);
    threads->setSuffix(" 线程");

    auto *speed = new QDoubleSpinBox(&window);
    speed->setRange(0.5, 3.0);
    speed->setDecimals(1);
    speed->setSingleStep(0.1);
    speed->setValue(1.0);
    speed->setSuffix("x");

    auto *volume = new QSlider(Qt::Horizontal, &window);
    volume->setRange(0, 100);
    volume->setValue(50);
    volume->setTickPosition(QSlider::TicksBelow);
    volume->setTickInterval(10);

    auto *volumeLabel = new QLabel("50%", &window);

    // 滑块本身保存整数,标签负责把当前值显示成百分比。
    QObject::connect(volume, &QSlider::valueChanged,
                     volumeLabel, [volumeLabel](int value) {
        volumeLabel->setText(QString::number(value) + "%");
    });

    layout->addRow("线程数", threads);
    layout->addRow("播放速度", speed);
    layout->addRow("音量", volume);
    layout->addRow("当前音量", volumeLabel);

    window.resize(360, 180);
    window.show();

    return app.exec();
}

预期结果

text
启动后出现一个“数值输入”窗口。
线程数初始为 4,允许范围为 1~16。
播放速度初始为 1.0x,允许范围为 0.5x~3.0x。
音量初始为 50;拖动滑块后,“当前音量”标签同步显示对应百分比。

读取值时关注业务语义

QSpinBox::value() 返回 int,QDoubleSpinBox::value() 返回 double,QSlider::value() 返回 int。提交表单或执行计算时,应读取数值属性,而不是解析控件显示出来的文本,因为前缀、后缀和本地化格式只属于显示层。

当用户必须准确输入离散值时优先使用 Spin Box;当用户更关心相对大小和快速调整时使用 Slider。若滑块代表小数或其他非整数业务量,应明确设计整数位置与业务值之间的映射,而不是把两者混为一谈。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用数值控件输入范围数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通