Qt 是一个跨平台C++图形界面开发库,利用Qt可以快速开发跨平台窗体应用程序,在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置,实现图形化开发极大的方便了开发效率,本章将重点介绍QSpinBox
精度数值组件的常用方法及灵活运用。
QSpinBox
是Qt框架中的一个部件(Widget),用于提供一个方便用户输入整数值的界面元素。它通常以微调框(SpinBox)的形式展现,用户可以通过微调框上的按钮或手动输入来增加或减少整数值。在实际使用中该控件主要用于整数或浮点数的计数显示,与普通的LineEdit
组件不同,该组件可以在前后增加特殊符号并提供了上下幅度的调整按钮,灵活性更强。
使用场景:
- 数值输入: 适用于需要用户输入整数值的场景,如设置参数、调整数量等。
- 调整参数: 在需要进行微小调整的地方,提供直观的增减按钮。
- 限制输入范围: 当需要确保用户输入在一定范围内时,可设置最小值和最大值。
- 只读展示: 可以用于只读展示某个数值,不允许用户修改。
以下是QSpinBox
类的一些常用方法,说明并概述成表格:
方法 |
描述 |
QSpinBox(QWidget *parent = nullptr) |
构造函数,创建一个整数微调框。 |
int value() const |
获取当前微调框中的整数值。 |
void setValue(int value) |
设置微调框的整数值。 |
int minimum() const |
获取微调框的最小值。 |
void setMinimum(int min) |
设置微调框的最小值。 |
int maximum() const |
获取微调框的最大值。 |
void setMaximum(int max) |
设置微调框的最大值。 |
int singleStep() const |
获取单步步进值,即微调框在每次增减操作时的变化量。 |
void setSingleStep(int step) |
设置单步步进值。 |
int prefix() const |
获取前缀(显示在值之前的文本)。 |
void setPrefix(const QString &prefix) |
设置前缀。 |
int suffix() const |
获取后缀(显示在值之后的文本)。 |
void setSuffix(const QString &suffix) |
设置后缀。 |
QString cleanText() const |
获取文本表示的干净值,即不包含前缀和后缀的纯文本值。 |
bool wrapping() const |
检查微调框是否启用了循环,即在达到最大或最小值时是否绕回。 |
void setWrapping(bool on) |
启用或禁用微调框的循环。 |
void stepUp() |
将微调框的值增加一个单步步进值。 |
void stepDown() |
将微调框的值减少一个单步步进值。 |
void setAccelerated(bool on) |
启用或禁用加速,即按住上下箭头时值的变化速度是否逐渐加快。 |
bool isAccelerated() const |
检查是否启用了加速。 |
void setReadOnly(bool ro) |
设置微调框为只读模式,禁止用户编辑值。 |
bool isReadOnly() const |
检查微调框是否为只读模式。 |
void setAlignment(Qt::Alignment align) |
设置微调框中文本的对齐方式。 |
Qt::Alignment alignment() const |
获取微调框中文本的对齐方式。 |
void setButtonSymbols(QAbstractSpinBox::ButtonSymbols bs) |
设置增减按钮的显示方式。 |
QAbstractSpinBox::ButtonSymbols buttonSymbols() const |
获取增减按钮的显示方式。 |
这些方法涵盖了QSpinBox
类中一些常用的设置和获取整数微调框属性的功能。
接下来我将用一个简单的案例展示如何使用SpinBox
组件,该组件有两个版本SpinBox()
用于展示单精度浮点数,而DoubleSpinBox()
则可以展示精度更高的数值,需要注意的是,该组件有两个特殊参数,当使用setPrefix()
时可以指定在前方加入特殊符号,而使用setSuffix()
时则可以在后方追加特殊符号,我们就以后方追加为例,首先绘制一个窗体;
要实现计算流程很简单,只需要在按钮被触发时直接调用on_pushButton_clicked()
按钮事件即可,其核心代码如下所示;
MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 在组件后方设置$特殊符号
ui->spinBox->setSuffix(" $");
ui->spinBox_2->setSuffix(" $");
ui->doubleSpinBox->setSuffix(" $");
// 设置显示精度
ui->doubleSpinBox->setDecimals(6);
}
MainWindow::~MainWindow()
{
delete ui;
}
// 触发计算流程
void MainWindow::on_pushButton_clicked()
{
int x = ui->spinBox->value();
int y = ui->spinBox_2->value();
double total = x+y;
// 设置SpinBox数值(设置时无需转换)
ui->doubleSpinBox->setValue(total);
}
我们继续在SpinBox
的基础上改进,如上代码中每次都需要点击计算按钮才能出结果,此时的需求是当SpinBox
中的参数发生变化时自定的完成计算,这里就需要用到信号和槽了,当SpinBox
被修改后,自动触发计算信号实现计算。该需求很容易被实现,只需要将信号绑定到特定的槽函数上即可,核心代码如下所示;
MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 在组件后方设置$特殊符号
ui->spinBox->setSuffix(" $");
ui->spinBox_2->setSuffix(" $");
ui->doubleSpinBox->setSuffix(" $");
// 设置显示精度
ui->doubleSpinBox->setDecimals(6);
// 始终不可编辑
ui->doubleSpinBox->setEnabled(false);
// 将数量和单价两个SpinBox的valueChanged()信号与on_pushButton_clicked()槽关联
// 只要spinBox中的内容发生变化,则立即触发按钮完成计算
QObject::connect(ui->spinBox,SIGNAL(valueChanged(int)),this,SLOT(on_pushButton_clicked()));
QObject::connect(ui->spinBox_2,SIGNAL(valueChanged(int)),this,SLOT(on_pushButton_clicked()));
QObject::connect(ui->doubleSpinBox,SIGNAL(valueChanged(double)),this,SLOT(on_pushButton_clicked()));
}
编译并运行上述程序,当我们的两个选择框其中一个发生变化时,都会自动触发信号与on_pushButton_clicked()
实现计算,效果图如下;