Python GUI库图形界面开发之PyQt5计数器控件QSpinBox详细使用方法与实例
发布时间：2026-10-13| 5人浏览过
本文详细介绍PyQt5中QSpinBox计数器控件的使用方法。QSpinBox允许用户通过按钮或键盘调整整数值，默认范围0-99，步长1。文章涵盖常用方法如setRange、setValue，并通过完整代码示例演示如何将valueChanged信号与槽函数连接，实现数值实时显示。
PyQt5计数器控件QSpinBox简介
QSpinBox是一个计数器控件，允许用户通过单击向上或向下按钮，或使用键盘上的上下键来增加或减少当前显示的值。当然，用户也可以直接输入值。
在默认情况下，QSpinBox的取值范围是（0-99），每次改变的步长是1。
QSpinBox类和QDoubleSpinbox类均派生自QAbstractSpinBox类，QSpinBox用于处理整数值，QDoubleSpinBox则用于处理浮点数值，他们之间的区别就是处理数据的类型不同，其他功能基本相同，QDoubleSpinBox的默认精度是两位小数，但可以通过setDecimals（）来改变
QSpinBox类中的常用方法
| 方法 | 描述 |
|---|---|
| setMinimum() | 设置计数器的下界 |
| setMaximum() | 设置计数器的上界 |
| setRange() | 设置计数器的最大值，最小值，步长值 |
| setValue() | 设置计数器的当前值 |
| Value() | 返回计数器的当前值 |
| singleStep() | 设置计数器的步长值 |
QSpinBox的使用实例
import sys
from PyQt5.QtWidgets import *
from PyQt5.QtCore import *
from PyQt5.QtGui import *
class spindemo(QWidget):
def __init__(self,parent=None):
super(spindemo, self).__init__(parent)
#设置标题与初始大小
self.setWindowTitle('SpinBox 例子')
self.resize(300,100)
#垂直布局
layout=QVBoxLayout()
#创建按钮并设置居中
self.l1=QLabel('current value')
self.l1.setAlignment(Qt.AlignCenter)
layout.addWidget(self.l1)
#创建计数器，并添加控件，数值改变时发射信号触发绑定事件
self.sp=QSpinBox()
layout.addWidget(self.sp)
self.sp.valueChanged.connect(self.Valuechange)
self.setLayout(layout)
def Valuechange(self):
#显示当前计数器地数值
self.l1.setText('current value:'+str(self.sp.value()))
if __name__ == '__main__':
app=QApplication(sys.argv)
ex=spindemo()
ex.show()
sys.exit(app.exec_())运行效果如图
QSpinBox代码分析：
在这个例子中，有一个标签和计数器放置在一个垂直布局管理器中，并把这个垂直布局管理器放置在窗口中，将计数器的valueChanged信号连接到槽函数valuechange（），其核心代码是
self.sp.valueChanged.connect(self.Valuechange)valuechange（）函数把计数器的当前值设置到标签文本中
self.l1.setText('current value:'+str(self.sp.value()))本文主要讲解了PyQt5计数器控件QSpinBox详细使用方法与实例，更多关于PyQt5控件知识请查看下面的相关链接
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
