简述

QSpinBox类提供了一个微调框部件。

QSpinBox旨在处理整数和离散值（例如：月份名称），而QDoubleSpinBox用于处理浮点值。

详细描述

QSpinBox允许用户选择一个值，通过单击向上/向下按钮或按下键盘的上/下箭头来增加/减少当前显示的值，用户也可以输入值。微调框支持整数值，但可以被扩展为不同的字符串，使用validate()、textFromValue()和valueFromText()。

当QSpinBox的值发生改变时，会发射两个valueChanged()信号，其中一个提供int类型，另一个则是QString类型，该QString提供了prefix()和suffix()。当前值可以用value()来读取，setValue()来设置。

单击向上/向下按钮或按下键盘的上/下箭头时，将以singleStep()为步长增加/减少当前值。如果想改变这种行为，可以重载虚函数stepBy()。最小值、最大值和步长可以使用其中的一个构造函数来设置，以后可以用setMinimum()、setMaximum()和setSingleStep()来修改。

大多数微调框是定向的，但也可以设置为循环的。例如：如果取值范围是0 - 99，当前值是99，如果wrapping()被设置为true，点击“向上”按钮值会变为0。如果你想要一个循环微调框，可以使用setWrapping()函数。

显示的值可以和任意的字符串进行附加，适用setPrefix()和setSuffix()分别可以设置前缀和后缀，例如：货币或计量单位。微调框中的文本可以用text()（包括任何前缀和后缀）或者通过cleanText()（没有前缀()、没有后缀()、无前导或结尾空白）来获取。

通常需要给用户一个特殊的（通常是默认的）选择除了数值的范围。参见QSpinBox的setSpecialValueText()如何做到这一点。

基本使用

构建一个QSpinBox，范围：20 - 200，步长：10，开启循环。

效果

源码

设置步长为10以后，当值发生改变时，就会在当前值的基础上±10（相当于一个等差数列，公差为10）。当我们开启循环后，当前值达到最大或者最小时，就会循环（类似于听歌的列表循环）。

#include <QSpinBox>

class MainWindow : public CustomWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = 0)
        : CustomWindow(parent)
    {
        // ...
        m_pSpinBox = new QSpinBox(this);
        m_pSpinBox->setRange(20, 200);  // 范围
        m_pSpinBox->setSingleStep(10); // 步长
        m_pSpinBox->setValue(150);  // 当前值
        m_pSpinBox->setPrefix("$ ");  // 前缀
        m_pSpinBox->setSuffix(" %");  // 后缀
        m_pSpinBox->setWrapping(true);  // 开启循环

        // 连接信号槽
        connect(m_pSpinBox, SIGNAL(valueChanged(int)), this, SLOT(onValueChanged(int)));
        connect(m_pSpinBox, SIGNAL(valueChanged(QString)), this, SLOT(onValueChanged(QString)));
    }

private slots:
    void onValueChanged(int value) {
        qDebug() << "Value : "  << value;
        qDebug() << "Text : "  << m_pSpinBox->text();
    }

    void onValueChanged(const QString &text) {
        qDebug() << "Text Value : "  << text;
        qDebug() << "Clean Text : " << m_pSpinBox->cleanText();
    }

private:
    QSpinBox *m_pSpinBox;
};

输出如下：

Text Value : "$ 160 %"
Clean Text : "160"
Value : 160
Text : "$ 160 %"

特殊文本值

如果设置了specialValueText，只要当前值等于微调框的最小值时，将显示该文本，而不是一个数值。典型的用途是表明此选择具有特殊（默认）的意思。

例如，如果你的微调框允许用户可以选择一个比例系数（或缩放级别），用于显示图像，并且应用程序能够自动选择一个，将使图像完全符合显示窗口，可以像这样设置微调框：

效果

源码

QSpinBox *zoomSpinBox = new QSpinBox;
zoomSpinBox->setRange(0, 1000);
zoomSpinBox->setSingleStep(10);
zoomSpinBox->setSuffix("%");
zoomSpinBox->setSpecialValueText(tr("Automatic"));
zoomSpinBox->setValue(100);

一旦当前值变为最小值时，显示的就是Automatic。

子类化QSpinBox

如果使用prefix()、suffix()和specialValueText()没有提供足够的控制，可以子类化QSpinBox，重写valueFromText()和textFromValue()。

例如，自定义一个微调框，允许用户输入图标大小（例如：”32 x 32”）：

效果

源码

class IconSizeSpinBox : public QSpinBox
{
    Q_OBJECT

public:
    explicit IconSizeSpinBox(QWidget *parent = 0){}

protected:
    // 将输入的文本解读为适当的值
    virtual int valueFromText(const QString &text) const Q_DECL_OVERRIDE
    {
        QRegExp regExp(tr("(\\d+)(\\s*[xx]\\s*\\d+)?"));

        if (regExp.exactMatch(text)) {
            return regExp.cap(1).toInt();
        } else {
            return 0;
        }
    }
    // 根据输入的值返回文本
    virtual QString textFromValue(int value) const Q_DECL_OVERRIDE
    {
        return tr("%1 x %1").arg(value);
    }
};

常用的基本就这些，如果需要更多其他的特性，请参考QAbstractSpinBox。