QDoubleValidator Class

Documentación de las funciones miembro

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

Construye un objeto validador con un objeto parent que acepta cualquier double.

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

Construye un objeto validador con un objeto parent. Este validador aceptará dobles de bottom a top inclusive, con hasta decimals dígitos después del punto decimal.

[virtual noexcept] QDoubleValidator::~QDoubleValidator()

Destruye el validador.

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

Reimplementa: QValidator::fixup(QString &input) const.

Intenta fijar la cadena input a una representación Acceptable de un doble.

El formato del número viene determinado por notation(), decimals(), locale() y el último numberOptions().

Para cumplir con notation(), cuando se utilice ScientificNotation, el valor fijo se representará en su forma normalizada, lo que significa que cualquier valor distinto de cero tendrá un dígito distinto de cero antes del punto decimal.

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

Para cumplir con decimals(), cuando sea -1 el número de dígitos utilizados vendrá determinado por QLocale::FloatingPointShortest. En caso contrario, la parte fraccionaria del número se truncará (con redondeo, según proceda) si su longitud supera decimals(). Cuando notation() es ScientificNotation esto se hace después de que el número haya sido puesto en su forma normalizada.

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

Esta función se introdujo en Qt 6.3.

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

Establece el validador para que acepte dobles de minimum a maximum inclusive, con un máximo de decimals dígitos después del punto decimal.

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

Establece el validador para aceptar dobles de minimum a maximum inclusive sin cambiar el número de dígitos después del punto decimal.

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

Reimplementa: QValidator::validate(QString &input, int &pos) const.

Devuelve Acceptable si la cadena input está en el formato correcto y contiene un double dentro del rango válido.

Devuelve Intermediate si input está en el formato incorrecto o contiene un double fuera del rango.

Devuelve Invalid si input no representa un doble o tiene demasiados dígitos después del punto decimal.

Nota: Si el rango válido consiste sólo en dobles positivos (por ejemplo, 0.0 a 100.0) y input es un doble negativo, entonces se devuelve Invalid. Si notation() es StandardNotation, y la entrada contiene más dígitos antes del punto decimal de los que puede tener un doble en el rango válido, se devuelve Invalid. Si notation() es ScientificNotation, y la entrada no está en el rango válido, se devuelve Intermediate. El valor aún puede volverse válido cambiando el exponente.

Por defecto, el parámetro pos no es utilizado por este validador.