PyQt QDoubleSpinBox控件用法示例详解

 更新时间:2025年04月02日 09:59:50   作者:QMT量化交易  
QDoubleSpinBox 是 PyQt中用于输入浮点数的控件,支持键盘输入和上下箭头调整数值,本文给大家介绍PyQt QDoubleSpinBox控件用法,感兴趣的朋友一起看看吧

QDoubleSpinBox 是 PyQt中用于输入浮点数的控件,支持键盘输入和上下箭头调整数值。与QtSpinBox不同,QtSpinBox是用于输入整数的控件。

关键属性和方法

QDoubleSpinBox 的关键属性和方法如下表所示:

方法/属性说明
setRange(min, max)设置数值范围
setSingleStep(step)设置步长(箭头点击一次的变化量)
setDecimals(n)设置小数位数
setValue(value)设置当前值
value()获取当前值
valueChanged数值变化时触发的信号
setPrefix(text)添加前缀文本
setSuffix(text)添加后缀文本

基础设置方法

  • setRange(min, max)
  • 设置数值范围(最小值 min,最大值 max)。
  • setMinimum(min) / setMaximum(max)
  • 单独设置最小值或最大值。
  • setSingleStep(step)
  • 设置步长(点击箭头时数值的变化量)。
  • setDecimals(prec)
  • 设置显示的小数位数(如 prec=2 保留两位小数)。
  • setValue(value)
  • 直接设置当前值(需确保值在范围内)。
  • setPrefix(text) / setSuffix(text)
  • 添加前缀或后缀文本(如单位符号)。

值获取方法

  • value()
  • 返回当前数值(浮点数类型)。
  • textFromValue(value) / valueFromText(text)
  • 自定义数值与文本的转换逻辑(用于输入验证或格式化)。

行为控制方法

  • setKeyboardTracking(enabled)
  • 控制是否在输入时实时更新值(默认 True,实时更新;设为 False 则在输入完成后更新)。
  • stepBy(steps)
  • 按步长增量调整值(正数增加,负数减少)。
  • stepUp() / stepDown()
  • 触发一次步长增加或减少操作。

输入验证方法

  • setCorrectionMode(mode)
  • 设置输入修正模式(如 QDoubleSpinBox.CorrectToNearestValue 自动修正非法值)。
  • validate(text, pos) / fixup(text)
  • 自定义输入验证逻辑(需重写方法)。

信号

  • valueChanged(double)
  • 数值变化时触发的信号(参数为当前值)。
  • editingFinished()
  • 用户结束编辑(如按下回车或焦点离开)时触发。

其他实用方法

  • clear()
  • 清空值(重置为最小值或 0.0,取决于范围)。
  • setAlignment(alignment)
  • 设置文本对齐方式(如 Qt.AlignRight)。
  • setReadOnly(enabled)
  • 设为只读模式(用户不可编辑)。

用法示例

控件初始化

from PyQt5.QtWidgets import QApplication, QWidget, QDoubleSpinBox, QVBoxLayout
app = QApplication([])
window = QWidget()
layout = QVBoxLayout()
# 创建控件并设置初始属性
spinbox = QDoubleSpinBox()
spinbox.setRange(-100.0, 100.0)   # 设置数值范围
spinbox.setSingleStep(0.5)        # 设置步长(箭头点击一次的变化量)
spinbox.setDecimals(2)            # 保留两位小数
spinbox.setValue(3.14)            # 设置初始值
layout.addWidget(spinbox)
window.setLayout(layout)
window.show()
app.exec_()

信号与槽连接

当用户修改数值时,触发 valueChanged 信号:

def on_value_changed(value):
    print(f"当前值: {value}")
spinbox.valueChanged.connect(on_value_changed)

动态调整范围

根据条件动态修改范围或步长:

# 当数值超过50时,自动扩展范围
def check_range(value):
    if value > 50.0:
        spinbox.setRange(0.0, 100.0)
    else:
        spinbox.setRange(0.0, 50.0)
spinbox.valueChanged.connect(check_range)

格式化显示

添加前缀/后缀或自定义格式:

spinbox.setPrefix("温度: ")     # 添加前缀
spinbox.setSuffix("°C")        # 添加后缀
# 使用自定义格式(如货币)
spinbox.setDecimals(0)
spinbox.setPrefix("$ ")

输入验证

限制用户输入非法值(如超过范围时自动修正):

spinbox.setKeyboardTracking(False)  # 输入完成后再验证(而非实时)
def validate_input(value):
    if value < 0:
        return 0.0  # 自动修正为最小值
    return value
spinbox.valueFromText = lambda text: validate_input(float(text))

高级用法:自定义步长逻辑

根据当前值动态调整步长(如对数刻度):

def dynamic_step(value):
    if value < 1.0:
        return 0.1
    elif value < 10.0:
        return 0.5
    else:
        return 1.0
spinbox.setSingleStep(0.1)  # 初始步长
def on_step_up():
    current = spinbox.value()
    step = dynamic_step(current)
    spinbox.setValue(current + step)
def on_step_down():
    current = spinbox.value()
    step = dynamic_step(current)
    spinbox.setValue(current - step)
# 替换默认的上下箭头行为
spinbox.stepUp.connect(on_step_up)
spinbox.stepDown.connect(on_step_down)

到此这篇关于PyQt QDoubleSpinBox控件用法详解的文章就介绍到这了,更多相关PyQt QDoubleSpinBox控件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • pandas.DataFrame.drop_duplicates 用法介绍

    pandas.DataFrame.drop_duplicates 用法介绍

    这篇文章主要介绍了pandas.DataFrame.drop_duplicates 用法介绍,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-07-07
  • python删除指定类型(或非指定)的文件实例详解

    python删除指定类型(或非指定)的文件实例详解

    这篇文章主要介绍了python删除指定类型(或非指定)的文件,以实例形式较为详细的分析了Python删除文件的相关技巧,需要的朋友可以参考下
    2015-07-07
  • python类方法和静态方法详解

    python类方法和静态方法详解

    这篇文章主要为大家介绍了python类方法和静态方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-01-01
  • 解决DataFrame排序sort的问题

    解决DataFrame排序sort的问题

    今天小编就为的大家分享一篇解决DataFrame排序sort的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-06-06
  • 使用Termux在手机上运行Python的详细过程

    使用Termux在手机上运行Python的详细过程

    这篇文章主要介绍了使用Termux在手机上运行Python的详细过程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-10-10
  • Pytorch之contiguous的用法

    Pytorch之contiguous的用法

    今天小编就为大家分享一篇Pytorch之contiguous的用法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-12-12
  • python中的import绝对导入与相对导入详解

    python中的import绝对导入与相对导入详解

    这篇文章主要介绍了python中的import绝对导入与相对导入详解,在使用python做一些简单项目时,import一般不会出现问题,但项目结构复杂时,import可能发生报错,需要的朋友可以参考下
    2023-11-11
  • pycharm实现猜数游戏

    pycharm实现猜数游戏

    这篇文章主要为大家详细介绍了pycharm实现猜数游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-12-12
  • 详解python中__name__的意义以及作用

    详解python中__name__的意义以及作用

    这篇文章主要介绍了详解python中__name__的意义以及作用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-08-08
  • Python----数据预处理代码实例

    Python----数据预处理代码实例

    这篇文章主要介绍了Python数据预处理,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03

最新评论