QDoubleValidator Class

成员函数文档

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

使用parent 对象构造验证器对象，该对象可接受任何 double。

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 时，固定值将以其规范化形式表示，这意味着任何非零值都将在小数点前有一位非零数字。

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 不能表示双数或小数点后数字过多，则返回Invalid 。

注：如果有效范围内只有正二进制数（如 0.0 至 100.0），而input 是负二进制数，则返回Invalid 。如果notation() 设置为StandardNotation ，且输入值小数点前的位数多于有效范围内的双倍数，则返回Invalid 。如果notation() 设置为ScientificNotation ，而输入值不在有效范围内，则返回Intermediate 。通过改变指数，该值可能会变为有效值。

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