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()

このシグナルは、編集が完了した際に発信されます。これは、スピンボックスがフォーカスを失ったときや、Enterキーが押されたときに発生します。

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

QWidget::event(QEvent *event) を再実装します。

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

この仮想関数は、Returnキーが押されたとき、または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

option を、QSpinBox の値で初期化します。このメソッドは、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 を返す場合、スピンボックスの内部バリデータはラインエディットに設定されます。

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()

1ラインステップ分下へ移動します。このスロットを呼び出すことは、stepBy(-1); を呼び出すのと同じです。

stepBy() およびstepUp()も参照してください 。

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

任意の時点で、ステップアップおよびステップダウンが有効かどうかを判定する仮想関数。

(stepEnabled() &StepUpEnabled) != 0 でない限り、上矢印は使用不可として描画されます。

ラップ機能が有効になっている場合、デフォルトの実装は (StepUpEnabled|StepDownEnabled) を返します。そうでない場合、value が > minimum() のときはStepDownEnabled を返し、value が < maximum() のときはStepUpEnabled と論理和（OR）をとり、その結果を返します。

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) を再実装します。