Qt QSpinBox 总结

Qt5 QSpinBox 总结

1. 基本特性

  • 用途:用于输入和调整整数值,支持通过上下箭头、键盘输入或编程方式修改值。

  • 默认范围:0 到 99,可通过 setRange(min, max) 自定义。

  • 步长控制:setSingleStep(step) 设置单步增减值(默认为1)。

  • 前缀/后缀:支持通过 setPrefix() 和 setSuffix() 添加文本(如 $ 或 px),仅用于显示,不影响实际值。

  • 进制显示:支持十进制(默认)、十六进制(setDisplayIntegerBase(16))、二进制等。

2. 核心方法

方法 说明
value() / setValue(int) 获取或设置当前值。
minimum() / maximum() 获取最小/最大值。
setRange(int min, int max) 同时设置最小值和最大值。
setSingleStep(int step) 设置单步增减步长。
setPrefix(const QString&) 设置数值前显示的前缀(如 $)。
setSuffix(const QString&) 设置数值后显示的后缀(如 px)。
setWrapping(bool enable) 启用/禁用循环(达到极值后绕回)。
setAccelerated(bool enable) 启用加速(长按箭头时快速增减值)。

3. 关键信号


信号 说明
valueChanged(int) 值变化时触发,传递新整数值。
textChanged(const QString&) 文本(含前缀/后缀)变化时触发。

4. 样式定制

  • QSS 示例:
c++ 复制代码
QSpinBox {
    border: 2px solid #3498db;
    border-radius: 5px;
    padding: 5px;
}
QSpinBox::up-button { /* 上箭头样式 */ }
QSpinBox::down-button { /* 下箭头样式 */ }

5. 子类化与自定义

  • 输入验证:覆盖 validate() 和 valueFromText() 实现自定义格式(如带单位的输入)。

  • 事件处理:重写 keyPressEvent() 或 wheelEvent() 修改默认交互逻辑。

6. 注意事项

  • 输入过滤:自动过滤非数字字符,用户无需手动处理。

  • 键盘交互:

    上下箭头键:按步长调整值。

    PageUp/PageDown:按步长×10调整值。

  • 值与显示分离:value() 始终返回整数,前缀/后缀仅用于显示。

  • 信号选择:优先用 valueChanged(int) 避免处理文本解析。

7. 典型应用场景

  • 数值输入(如年龄、数量、尺寸)。

  • 与 QSlider 联动,实现双向数据绑定。

  • 参数配置界面(如字体大小、颜色通道值)。

8. 示例代码

c++ 复制代码
// 创建 QSpinBox 并设置属性
QSpinBox *spinBox = new QSpinBox;
spinBox->setRange(0, 100);          // 范围 0~100
spinBox->setSingleStep(5);          // 步长5
spinBox->setPrefix("$ ");           // 显示 "$ 数值"
spinBox->setValue(50);              // 初始值

// 连接信号
connect(spinBox, QOverload<int>::of(&QSpinBox::valueChanged), 
        [](int val) { qDebug() << "Value:" << val; });
相关推荐
心愿许得无限大29 分钟前
Qt 常用界面组件
开发语言·c++·qt
2401_8582861139 分钟前
OS15.【Linux】gdb调试器的简单使用
linux·运维·服务器·开发语言·gdb
牛马baby40 分钟前
MATLAB下载安装教程(附安装包)2025最新版(MATLAB R2024b)
开发语言·matlab
shenyan~1 小时前
关于 c、c#、c++ 三者区别
开发语言·c++
Ashlee_code1 小时前
什么是Web3?金融解决方案
开发语言·金融·架构·eclipse·web3·区块链·php
Evand J1 小时前
【MATLAB例程】AOA与TDOA混合定位例程,适用于三维环境、4个锚点的情况,附下载链接
开发语言·matlab
机器视觉知识推荐、就业指导1 小时前
Qt 与Halcon联合开发八: 结合Qt与Halcon实现海康相机采图显示(附源码)
开发语言·数码相机·qt
Heartoxx2 小时前
c语言-指针与一维数组
c语言·开发语言·算法
hqxstudying2 小时前
Java创建型模式---原型模式
java·开发语言·设计模式·代码规范
charlie1145141912 小时前
如何使用Qt创建一个浮在MainWindow上的滑动小Panel
开发语言·c++·qt·界面设计