QDoubleValidator Class

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

[explicit] QDoubleValidator::QDoubleValidator(QObject *parent = nullptr)

バリデータオブジェクトをparent オブジェクトで作成します。

QDoubleValidator::QDoubleValidator(double bottom, double top, int decimals, QObject *parent = nullptr)

バリデータオブジェクトをparent オブジェクトで作成します。このバリデータはbottom からtop までの倍数で、小数点以下がdecimals 桁までのものを受け取ります。

[virtual noexcept] QDoubleValidator::~QDoubleValidator()

バリデータを破棄する。

[override virtual, since 6.3] void QDoubleValidator::fixup(QString &input) const

再実装：QValidator::fixup(QString &input) const.

これはオーバーロードされた関数です。

input の文字列をAcceptable の double 表現に固定しようとします。

数値のフォーマットはnotation()、decimals()、locale()、そして後者のnumberOptions() によって決定される。

notation() に準拠するため、ScientificNotation を使用する場合、固定値は正規化された形式で表現される。つまり、ゼロ以外の値は、小数点の前にゼロ以外の桁が1つ付くことになる。

QString input = "0.98765e2";
QDoubleValidator val;
val.setLocale(QLocale::C);
val.setNotation(QDoubleValidator::ScientificNotation);
val.fixup(input); // input == "9.8765e+01"

decimals （）に準拠するため、-1 の場合、使用される桁数はQLocale::FloatingPointShortest によって決定される。そうでない場合、decimals() を超える長さの数値は、小数部が切り捨てられる(適宜、四捨五入される)。notation() がScientificNotation の場合、これは数値が正規化された後に行われる。

input = "-1234.6789";
val.setDecimals(2);
val.setLocale(QLocale::C);
val.setNotation(QDoubleValidator::StandardNotation);
val.fixup(input); // input == "-1234.68"

この関数は Qt 6.3 で導入されました。

void QDoubleValidator::setRange(double minimum, double maximum, int decimals)

minimum からmaximum までの倍数を受け付けるようにバリデータを設定し、 小数点以下の桁数は最大でもdecimals とします。

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

これはオーバーロードされた関数である。

小数点以下の桁数を変更せずに、minimum からmaximum までの倍数を受け付けるようにバリデータを設定します。

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

再実装：QValidator::validate(QString &input, int &pos) const.

文字列input が正しいフォーマットで、有効範囲内の double を含む場合、Acceptable を返します。

input の書式が正しくないか、範囲外の double が含まれている場合はIntermediate を返します。

input が double を表していないか、小数点以下の桁数が多すぎる場合はInvalid を返します。

注意：有効範囲が正の倍数（例えば、0.0 から 100.0）のみで構成され、input が負の倍数の場合は、Invalid が返される。notation() がStandardNotation に設定され、入力に有効範囲の double が持つ桁数よりも多い桁数が小数点の前に含まれる場合、Invalid が返される。notation() がScientificNotation で、入力が有効範囲にない場合、Intermediate が返される。指数を変更することで、有効な値になる可能性がある。

デフォルトでは、このバリデータはpos パラメータを使用しません。