firefly_star

Qt是一个跨平台C图形界面开发库利用Qt可以快速开发跨平台窗体应用程序在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置实现图形化开发极大的方便了开发效率本笔记将重点介绍QSpinBox数值微调组件的常用方法及灵活应用。? QSpinBox是Qt框架中的一个部件(Widget)用于提供一个方便用户输入整数值的界面元素。它通常以微调框(QSpinBox)的形式展示用户可以通过微调框上的按钮或手动输入来增加或减少整数值。在实际使用中该控件主要用于整型或浮点的计数显示与普通的LineEdit组件不同该组件可以在前后增加特殊符号并提供了上下幅度的调整按钮灵活性更强。其使用场景数值输入适用于需要用户输入整数值的场景如设置计算参数、调整数量等。调整参数在需要进行微小调整的地方提供直观的增减按钮。限制输入范围当需要确保用户输入在一定范围内时可以设置参数的最大值和最小值只读展示可以用于只读展示某个数值不允许用户修改。以下是QSpinBox类的一些常用方法API说明并概述成表格方法API 描 述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 获取后缀显示在值之后的文本。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类中一些常用的设置和获取整数微调框属性的功能。其信号部分信号声明 信号说明void textChanged(const QString text) 微调框的文本发生改变时会触发参数QString带有前缀和后缀void valueChanged(int i) 微调框的?本发?改变时会触发参数 int表示当前的数值接下来将用一个简单的案例展示如何使用 QSpinBox组件该组件有两个版本QSpinBox用于展示单精度浮点数而QDoubleSpinBox() 则可以展示精度更高的数值需要注意的是该组件有两个特殊参数当使用setPrefix() 时可以指定在前方加入特殊符号而使用 setSuffix() 时则可以在后方追加特殊符号我们就可以后方追加为例。以下是一个使用 QSpinBox 的 C Qt 示例展示了如何创建控件、设置属性并连接信号#include#include#include#include#includeclass MainWindow : public QWidget {Q_OBJECTpublic:MainWindow() {QSpinBox *spinBox new QSpinBox(this);spinBox-setRange(0, 100); // 设置范围 0-100spinBox-setValue(10); // 设置初始值spinBox-setSingleStep(5); // 设置步长为 5// 连接值改变信号到槽函数connect(spinBox, QOverload ::of(QSpinBox::valueChanged),this, MainWindow::onValueChanged);QVBoxLayout *layout new QVBoxLayout(this);layout-addWidget(spinBox);}public slots:void onValueChanged(int value) {qDebug() Spin box value changed to: value;}};int main(int argc, char *argv[]) {QApplication app(argc, argv);MainWindow window;window.show();return app.exec();}诼碧赣园