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; });
相关推荐
泽020225 分钟前
C++入门(缺省参数/函数/引用)
开发语言·c++
Themberfue2 小时前
Redis ⑦-set | Zset
java·开发语言·数据库·redis·sql·缓存
__lost3 小时前
MATLAB画出3d的常见复杂有机分子和矿物的分子结构
开发语言·人工智能·matlab·化学·分子结构
夜夜敲码4 小时前
C语言教程(十八):C 语言共用体详解
c语言·开发语言
大学生亨亨5 小时前
go语言八股文(五)
开发语言·笔记·golang
raoxiaoya5 小时前
同时安装多个版本的golang
开发语言·后端·golang
whoarethenext5 小时前
初始https附带c/c++源码使用curl库调用
服务器·c++·qt·https·curl
enyp806 小时前
麒麟系统(基于Ubuntu)上使用Qt编译时遇到“type_traits文件未找到”的错误
linux·qt·ubuntu
cloues break.6 小时前
C++进阶----多态
开发语言·c++
我不会编程5556 小时前
Python Cookbook-6.10 保留对被绑定方法的引用且支持垃圾回收
开发语言·python