不常用但超实用！QSpinBox 九大隐藏技巧

今天和大家分享一些 Qt 中QSpinBox控件的高级功能。这些功能不仅能让你的应用界面更加灵活，还能提升用户体验，尤其是在处理数值输入和界面交互时。虽然QSpinBox是一个常见的控件，大家经常用它来处理整数的输入，但它其实还有很多不常用但非常强大的功能，今天一起探讨一下。

1.信号对比：valueChanged、textChanged和editingFinished

在 Qt 中，QSpinBox提供了多个信号来响应数值变化。但它们之间有什么不同呢？我们来看看：

• valueChanged: 每次数值发生变化时都会触发，适合你需要处理数值更新的场景。
• textChanged: 当显示文本变化时触发，注意这包括了前后缀的变化哦！
• editingFinished: 用户完成编辑时触发，通常是在输入框失去焦点或按下回车后。

简单来说，valueChanged是跟数值直接相关的，textChanged则是跟文本格式变化有关，而editingFinished适用于用户完成输入的场景。

示例代码：

connect(sp,QOverload<int>::of(&QSpinBox::valueChanged),this,[=](intv){m_status->setText(QString("Signals -> valueChanged: %1").arg(v));});

2.范围与步进：range+singleStep

QSpinBox允许你设置数值的范围和步进值，来控制数值的输入限制以及每次修改时增加的数值。比如，你可以设置范围为 0 到 100，步进值为 5。

但它的高级功能也非常实用，比如动态调整步进值：你可以通过按钮轻松改变步进值，甚至设置成 1 或 10。

示例代码：

sp->setRange(0,100);sp->setSingleStep(5);sp->setValue(20);

3.前后缀：prefix+suffix

QSpinBox支持在输入数值时，前后添加一些文本或单位。比如你在做价格输入时，常常需要在数字前面加上“￥”，后面加上“元”。这时，prefix和suffix就非常有用了。

需要注意的是，这只是显示文本的变化，数值本身不会受到影响，value()方法返回的依然是纯数字。

示例代码：

sp->setPrefix("￥");sp->setSuffix(" 元");

4.特殊值文本：specialValueText

有时候我们需要让用户在输入框中看到一个特定的文本，而不是数字。比如，当数值为 0 时，我们可以显示“自动”或“默认”。这时就可以使用specialValueText属性。

这在需要让用户理解特定数值的意义时非常有用，尤其是在设置自动或默认值的场景。

示例代码：

sp->setSpecialValueText("自动（0）");

5.加速与环绕：accelerated+wrapping

• 加速: 按住上下箭头时，数值会加速变化，这对于快速调整数值非常有帮助。
• 环绕: 当数值达到上限时，继续增加会从最小值开始循环，反之亦然。

这两个功能对于一些需要快速调整数值的场景特别有用，比如音量调节、进度条等。

示例代码：

sp->setAccelerated(true);// 开启加速sp->setWrapping(true);// 开启环绕

6.进制显示：displayIntegerBase

如果你的应用需要显示不同进制的数值（例如十六进制或二进制），QSpinBox也能轻松实现。通过displayIntegerBase方法，你可以将数值的显示格式更改为二进制、十六进制或其他进制格式，但实际的数值依然是十进制。

示例代码：

sp->setDisplayIntegerBase(16);// 设置为十六进制sp->setPrefix("0x");

7.键盘跟踪：keyboardTracking

有时候我们需要在用户输入时即时更新数值，而不是等到输入框失去焦点或者按下回车后才更新。这时，keyboardTracking就派上用场了。开启该功能后，每次键盘输入都会即时更新QSpinBox的值。

示例代码：

connect(toggle,&QPushButton::toggled,this,[=](boolon){sp->setKeyboardTracking(on);});

8.自定义解析：支持输入 “1.5k” 这种格式

通过重写QSpinBox的validate、valueFromText和textFromValue方法，你可以支持更多的文本输入格式。比如，用户可以输入“1.5k”表示 1500，QSpinBox会自动将其转换为数字。

示例代码：

QStringKiloSpinBox::textFromValue(intv)const{returnQString::number(v);}intKiloSpinBox::valueFromText(constQString&text)const{QString t=text.trimmed().toLower();if(t.endsWith('k')){t.chop(1);boolok=false;doubled=t.toDouble(&ok);returnstatic_cast<int>(d*1000.0);}returnt.toInt();}

9.禁用滚轮误触：eventFilter

在一些场景中，用户的鼠标滚轮操作可能会误触发QSpinBox的数值变化，尤其是当QSpinBox被嵌套在滚动区域中时。此时，我们可以通过eventFilter来禁用滚轮的功能。

示例代码：

sp->installEventFilter(newNoWheelFilter(sp));

。