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; });
相关推荐
愚润求学4 分钟前
【C++】vector常用方法总结
开发语言·c++·vector
天天进步201513 分钟前
Python项目-基于Flask的个人博客系统设计与实现(1)
开发语言·python·flask
安然无虞15 分钟前
31天Python入门——第20天:魔法方法详解
开发语言·后端·爬虫·python
QQ__176461982419 分钟前
Matlab安装tdms插件
开发语言·matlab·tdms插件
画个逗号给明天"22 分钟前
C#从入门到精通(5)
开发语言·笔记·c#
赤秀1 小时前
C++模板初阶
开发语言·c++
橘猫云计算机设计1 小时前
基于JavaWeb的二手图书交易系统(源码+lw+部署文档+讲解),源码可白嫖!
java·开发语言·前端·毕业设计·php
半桔1 小时前
红黑树剖析
c语言·开发语言·数据结构·c++·后端·算法
江烽渔火1 小时前
C++ 多态
开发语言·c++
嘤国大力士1 小时前
C++11&QT复习 (十)
java·c++·qt