QDoubleValidator Class

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

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

任意のdouble値を受け入れるparent オブジェクトを持つバリデータオブジェクトを作成します。

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

parent オブジェクトを使用して、バリデータオブジェクトを作成します。このバリデータは、bottom からtop までの範囲（両端を含む）のdouble型値を受け入れ、小数点以下の桁数は最大decimals 桁まで許容します。

[virtual noexcept] QDoubleValidator::~QDoubleValidator()

バリデータを除去します。

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

QValidator::fixup(QString &input) const を再実装します。

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

数値の形式は、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 までの範囲（両端を含む）の double 型を受け入れ、小数点以下の桁数を最大decimals 桁に制限するように設定します。

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

小数点以下の桁数を変更することなく、minimum からmaximum までの範囲（両端を含む）の double 型を受け入れるようにバリデータの設定を行います。

[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 を返します。

注：有効範囲が正の double 型のみ（例：0.0 ～ 100.0）で構成されており、input が負の double 型である場合、Invalid が返されます。notation() がStandardNotation に設定されており、入力の小数点以下の桁数が有効範囲内の double 型が持つことができる桁数よりも多い場合、Invalid が返されます。notation()がScientificNotation に設定されており、入力が有効範囲外の場合、Intermediate が返されます。指数を変更することで、値が有効になる可能性があります。

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