QAbstractSpinBox Class

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

QSpinBox *spinBox = new QSpinBox(this);
spinBox->setRange(0, 100);
spinBox->setWrapping(true);
spinBox->setValue(100);
spinBox->stepBy(1);
// value is 0

成员函数文档

[explicit] QAbstractSpinBox::QAbstractSpinBox(QWidget *parent = nullptr)

根据给定的parent （默认值为wrapping ）以及对齐属性，构建一个抽象的旋转框。

[virtual noexcept] QAbstractSpinBox::~QAbstractSpinBox()

当QAbstractSpinBox 被销毁时调用。

[override virtual protected] void QAbstractSpinBox::changeEvent(QEvent *event)

重写了：QWidget::changeEvent(QEvent *event)。

[virtual slot] void QAbstractSpinBox::clear()

清除行编辑框中除前缀和后缀以外的所有文本。

[override virtual protected] void QAbstractSpinBox::closeEvent(QCloseEvent *event)

重写了：QWidget::closeEvent(QCloseEvent *event)。

[override virtual protected] void QAbstractSpinBox::contextMenuEvent(QContextMenuEvent *event)

重写了：QWidget::contextMenuEvent(QContextMenuEvent *event)。

[signal] void QAbstractSpinBox::editingFinished()

编辑完成后会发出此信号。当旋转输入框失去焦点或按下回车键时，都会触发此信号。

[override virtual] bool QAbstractSpinBox::event(QEvent *event)

重写了：QWidget::event(QEvent *event)。

[virtual] void QAbstractSpinBox::fixup(QString &input) const

当按下“返回”键或调用interpretText()时，如果input 未被验证为QValidator::Acceptable ，则QAbstractSpinBox 会调用此虚拟函数。它将尝试修改文本使其有效。该函数在各个子类中被重新实现。

[override virtual protected] void QAbstractSpinBox::focusInEvent(QFocusEvent *event)

重写了：QWidget::focusInEvent(QFocusEvent *event)。

[override virtual protected] void QAbstractSpinBox::focusOutEvent(QFocusEvent *event)

重写了：QWidget::focusOutEvent(QFocusEvent *event)。

[override virtual protected] void QAbstractSpinBox::hideEvent(QHideEvent *event)

重写了：QWidget::hideEvent(QHideEvent *event)。

[virtual protected] void QAbstractSpinBox::initStyleOption(QStyleOptionSpinBox *option) const

使用QSpinBox 中的值初始化option 。当子类需要QStyleOptionSpinBox ，但又不想自己填写所有信息时，此方法非常有用。

另请参阅 QStyleOption::initFrom()。

[override virtual] QVariant QAbstractSpinBox::inputMethodQuery(Qt::InputMethodQuery query) const

重写了：QWidget::inputMethodQuery （Qt::InputMethodQuery query）const。

void QAbstractSpinBox::interpretText()

该函数负责解析旋转输入框中的文本。如果自上次解析以来该值发生了变化，它将发出信号。

[override virtual protected] void QAbstractSpinBox::keyPressEvent(QKeyEvent *event)

重写了：QWidget::keyPressEvent(QKeyEvent *event)。

该函数处理键盘输入。

具体处理以下键：

另请参阅 stepBy()。

[override virtual protected] void QAbstractSpinBox::keyReleaseEvent(QKeyEvent *event)

重写了：QWidget::keyReleaseEvent(QKeyEvent *event)。

[protected] QLineEdit *QAbstractSpinBox::lineEdit() const

该函数返回一个指向旋转框的行编辑框的指针。

另请参阅 setLineEdit()。

[override virtual] QSize QAbstractSpinBox::minimumSizeHint() const

重新实现了属性QWidget::minimumSizeHint 的访问函数。

[override virtual protected] void QAbstractSpinBox::mouseMoveEvent(QMouseEvent *event)

重写了：QWidget::mouseMoveEvent(QMouseEvent *event)。

[override virtual protected] void QAbstractSpinBox::mousePressEvent(QMouseEvent *event)

重写了：QWidget::mousePressEvent(QMouseEvent *event)。

[override virtual protected] void QAbstractSpinBox::mouseReleaseEvent(QMouseEvent *event)

重写了：QWidget::mouseReleaseEvent(QMouseEvent *event)。

[override virtual protected] void QAbstractSpinBox::paintEvent(QPaintEvent *event)

重写了：QWidget::paintEvent(QPaintEvent *event)。

[override virtual protected] void QAbstractSpinBox::resizeEvent(QResizeEvent *event)

重写了：QWidget::resizeEvent(QResizeEvent *event)。

[signal, since 6.10] void QAbstractSpinBox::returnPressed()

当按下 Return 或 Enter 键时，会发出此信号。

该功能自 Qt 6.10 起引入。

[slot] void QAbstractSpinBox::selectAll()

选中旋转输入框中的所有文本，但不包括前缀和后缀。

[protected] void QAbstractSpinBox::setLineEdit(QLineEdit *lineEdit)

将旋转框的行编辑控件设置为lineEdit ，而非当前的行编辑控件。lineEdit 不能是nullptr 。

QAbstractSpinBox 获取新对象的所有权lineEdit

如果lineEdit 的QLineEdit::validator()方法返回nullptr ，则spinbox的内部验证器将设置为该行编辑控件。

另请参阅 lineEdit()。

[override virtual protected] void QAbstractSpinBox::showEvent(QShowEvent *event)

重写了：QWidget::showEvent(QShowEvent *event)。

[override virtual] QSize QAbstractSpinBox::sizeHint() const

重新实现了属性QWidget::sizeHint 的访问函数。

[virtual] void QAbstractSpinBox::stepBy(int steps)

每当用户触发一步时都会被调用的虚拟函数。steps 参数表示步数。例如，按下Qt::Key_Down 将触发对stepBy(-1) 的调用，而按下Qt::Key_PageUp 将触发对stepBy(10) 的调用。

若您继承了QAbstractSpinBox 类，则必须重写此函数。请注意，即使计算出的值超出最小值和最大值的范围，该函数仍会被调用。处理此类情况正是此函数的职责。

另请参阅 stepUp()、stepDown() 和keyPressEvent()。

[slot] void QAbstractSpinBox::stepDown()

向下移动一个行步。调用此插槽的效果与调用 `stepBy(-1)` 类似；

另请参阅 stepBy() 和stepUp()。

[virtual protected] QAbstractSpinBox::StepEnabled QAbstractSpinBox::stepEnabled() const

一个虚拟函数，用于确定在任意给定时刻，向上和向下步进是否合法。

除非 (stepEnabled() &StepUpEnabled) != 0，否则上箭头将被标记为禁用状态。

如果启用了循环功能，默认实现将返回 (StepUpEnabled|StepDownEnabled)。否则，如果值大于minimum()，则返回StepDownEnabled ；如果值小于maximum()，则返回StepUpEnabled 。

若您继承了QAbstractSpinBox 类，则需要重新实现此函数。

另请参阅 QSpinBox::minimum()、QSpinBox::maximum() 和wrapping()。

[slot] void QAbstractSpinBox::stepUp()

按行步长增加1。调用此插槽相当于调用stepBy(1)；

另请参阅 stepBy() 和stepDown()。

[override virtual protected] void QAbstractSpinBox::timerEvent(QTimerEvent *event)

重写了：QObject::timerEvent(QTimerEvent *event)。

[virtual] QValidator::State QAbstractSpinBox::validate(QString &input, int &pos) const

该虚拟函数由QAbstractSpinBox 调用，用于判断input 是否有效。参数pos 表示字符串中的位置。在各个子类中被重新实现。

[override virtual protected] void QAbstractSpinBox::wheelEvent(QWheelEvent *event)

重写了：QWidget::wheelEvent(QWheelEvent *event)。