QDoubleSpinBox Class

メンバ関数のドキュメント

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

最小値 0.0、最大値 99.99、ステップ値 1.0、小数点以下 2 桁の精度を持つスピンボックスを作成します。値は初期状態で 0.00 に設定されます。このスピンボックスには、指定されたparent が適用されます。

setMinimum()、setMaximum()、およびsetSingleStep()も参照してください 。

[virtual noexcept] QDoubleSpinBox::~QDoubleSpinBox()

デストラクタ。

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

QAbstractSpinBox::fixup （QString &input）const の再実装。

void QDoubleSpinBox::setRange(double minimum, double maximum)

minimum およびmaximum の値を、1回の関数呼び出しで設定できる便利な関数です。

注：最大値と最小値は、decimals プロパティに合わせて四捨五入されます。

setRange(minimum, maximum);

これは以下と同等です：

setMinimum(minimum);
setMaximum(maximum);

「 minimum 」および「maximum 」も参照してください 。

void QDoubleSpinBox::setStepType(QAbstractSpinBox::StepType stepType)

スピンボックスのステップタイプを「stepType 」に設定します。これは、シングルステップまたは適応型小数ステップです。

適応型小数ステップとは、ステップサイズが現在のvalue より10の累乗分だけ小さい値に継続的に調整されることを意味します。したがって、値が1100の場合、ステップは100に設定されるため、1回ステップアップすると1200になります。1200の場合、ステップアップすると1300になります。 負の値の場合、-1100からステップダウンすると-1200になります。

小数値に対しても同様に機能し、0.041は1ステップ増加すると0.042になります。

境界ケースを適切に処理するため、ステップの方向が考慮されます。したがって、100からステップダウンすると、値は90ではなく99になります。これにより、ステップアップの後にステップダウン（またはその逆）を行っても、常に開始値に戻ります（例：99 → 100 → 99）。

これを設定すると、スピンボックスはsingleStep の値を無視するようになりますが、その値は保持されるため、後で適応型小数ステップがオフにされた場合、singleStep が有効になります。

stepType()も参照してください 。

[signal] void QDoubleSpinBox::textChanged(const QString &text)

このシグナルは、スピンボックスのテキストが変更されるたびに発火します。新しいテキストは、`prefix()` および `suffix()` を通じて `text ` に渡されます。

[virtual] QString QDoubleSpinBox::textFromValue(double value) const

この仮想関数は、スピンボックスが指定されたvalue を表示する必要があるたびに使用されます。デフォルトの実装は、QWidget::locale()を使用してvalue を出力した文字列を返します。toString(value,u'f',decimals())が実行され、setGroupSeparatorShown()が設定されていない限り、千の位区切り記号が削除されます。再実装では、任意の値を返すことができます。

注：QDoubleSpinBox は、specialValueText()に対してこの関数を呼び出しません。また、prefix()もsuffix()も、戻り値に含めてはなりません。

これを再実装する場合は、valueFromText() も再実装する必要がある場合があります。

valueFromText() およびQLocale::groupSeparator()も参照してください 。

[override virtual] QValidator::State QDoubleSpinBox::validate(QString &text, int &pos) const

QAbstractSpinBox::validate(QString &input, int &pos) const を再実装します。

[signal] void QDoubleSpinBox::valueChanged(double d)

このシグナルは、スピンボックスの値が変更されるたびに発火します。新しい値は `d` に渡されます。

[virtual] double QDoubleSpinBox::valueFromText(const QString &text) const

この仮想関数は、ユーザーがtext に入力した内容を値として解釈する必要がある場合に、スピンボックスによって使用されます。

スピンボックスの値を数値以外の形式で表示する必要があるサブクラスは、この関数を再実装する必要があります。

注:QDoubleSpinBox は、specialValueText() を個別に処理します。この関数は、それ以外の値のみを対象としています。

textFromValue() およびvalidate()も参照してください 。