QDoubleValidator Class

成员函数文档

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

使用一个parent 对象构建一个验证器对象，该对象接受任何double类型的值。

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 ` 转换为 `Acceptable ` 格式的 `double` 数值。

该数字的格式由notation()、decimals()、locale()以及后者的numberOptions()决定。

为了符合notation() 的规范，当使用ScientificNotation 时，固定值将以归一化形式表示，这意味着任何非零值在小数点前都将有一个非零位。

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 ，且输入的小数点前位数超过有效范围内的双精度数值可能拥有的最大位数，则返回Invalid 。 如果notation()的值为ScientificNotation ，且输入值不在有效范围内，则返回Intermediate 。通过改变指数，该值仍可能变为有效值。

默认情况下，此验证器不使用pos 参数。