桌面应用 / 系统课时
用数值控件输入范围数据
用数值控件输入范围数据
当输入必须落在明确范围内时,让用户自由填写文本会增加校验成本。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 工程。窗口同时创建整数输入、小数输入和水平滑块,并实时显示滑块当前值。
#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();
}预期结果
启动后出现一个“数值输入”窗口。
线程数初始为 4,允许范围为 1~16。
播放速度初始为 1.0x,允许范围为 0.5x~3.0x。
音量初始为 50;拖动滑块后,“当前音量”标签同步显示对应百分比。读取值时关注业务语义
QSpinBox::value() 返回 int,QDoubleSpinBox::value() 返回 double,QSlider::value() 返回 int。提交表单或执行计算时,应读取数值属性,而不是解析控件显示出来的文本,因为前缀、后缀和本地化格式只属于显示层。
当用户必须准确输入离散值时优先使用 Spin Box;当用户更关心相对大小和快速调整时使用 Slider。若滑块代表小数或其他非整数业务量,应明确设计整数位置与业务值之间的映射,而不是把两者混为一谈。