En esta página

QDoubleValidator Class

La clase QDoubleValidator permite comprobar el rango de los números de coma flotante. Más información...

Encabezado: #include <QDoubleValidator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QValidator

Tipos públicos

enum Notation { StandardNotation, ScientificNotation }

Propiedades

Funciones públicas

QDoubleValidator(QObject *parent = nullptr)
QDoubleValidator(double bottom, double top, int decimals, QObject *parent = nullptr)
virtual ~QDoubleValidator()
double bottom() const
int decimals() const
QDoubleValidator::Notation notation() const
void setBottom(double)
void setDecimals(int)
void setNotation(QDoubleValidator::Notation)
void setRange(double minimum, double maximum, int decimals)
void setRange(double minimum, double maximum)
void setTop(double)
double top() const

Funciones públicas reimplementadas

(since 6.3) virtual void fixup(QString &input) const override
virtual QValidator::State validate(QString &input, int &pos) const override

Descripción detallada

QDoubleValidator proporciona un límite superior, un límite inferior y un límite en el número de dígitos después de la coma decimal.

Se puede establecer el rango aceptable en una sola llamada con ` setRange()` o con ` setBottom()` y ` setTop()`. Establezca el número de decimales con ` setDecimals()`. La función ` validate()` devuelve el estado de validación.

QDoubleValidator utiliza su locale() para interpretar el número. Por ejemplo, en la configuración regional alemana, «1,234» se aceptará como el número fraccionario 1,234. En las configuraciones regionales árabes, QDoubleValidator aceptará dígitos árabes.

Nota: La opción QLocale::NumberOptions establecida en locale() también afecta a la forma en que se interpreta el número. Por ejemplo, dado que QLocale::RejectGroupSeparator no está activado por defecto (excepto en la configuración regional "C" ), el validador aceptará separadores de grupos. Si la cadena supera la validación, pásala a locale().toDouble() para obtener su valor numérico.

Véase también QIntValidator, QRegularExpressionValidator, QLocale::toDouble() y el ejemplo de campos de edición de línea.

Documentación sobre tipos de miembros

enum QDoubleValidator::Notation

Esta enumeración define las notaciones permitidas para introducir un número de tipo «double».

ConstanteValorDescripción
QDoubleValidator::StandardNotation0La cadena se escribe en el formato estándar: una parte entera seguida, opcionalmente, de un separador y una parte fraccionaria; por ejemplo, "0.015".
QDoubleValidator::ScientificNotation1La cadena se escribe en forma científica, que añade opcionalmente una parte exponencial al formato estándar, por ejemplo, "1.5E-2".

La parte entera puede, como es habitual, incluir un signo. Esto, junto con los separadores de la parte fraccionaria, el exponente y cualquier agrupamiento de dígitos, depende de la configuración regional. QDoubleValidator no comprueba la ubicación (que también dependería de la configuración regional) de los separadores de agrupamiento de dígitos que encuentre, pero rechazará las entradas que los contengan si se ha establecido QLocale::RejectGroupSeparator en locale().numberOptions().

Véase también QLocale::numberOptions(), QLocale::decimalPoint(), QLocale::exponential() y QLocale::negativeSign().

Documentación de propiedades

bottom : double

Esta propiedad contiene el valor mínimo aceptable del validador

Por defecto, esta propiedad contiene un valor de -infinito.

Funciones de acceso:

double bottom() const
void setBottom(double)

Véase también ` setRange()`.

decimals : int

Esta propiedad establece el número máximo de dígitos que admite el validador después de la coma decimales

Por defecto, esta propiedad contiene el valor -1, lo que significa que se acepta cualquier número de dígitos.

Funciones de acceso:

int decimals() const
void setDecimals(int)

Véase también setRange().

notation : Notation

Esta propiedad define la notación que utiliza una cadena para representar un número

Por defecto, esta propiedad está establecida en « ScientificNotation ».

Funciones de acceso:

QDoubleValidator::Notation notation() const
void setNotation(QDoubleValidator::Notation)

Véase también Notation.

top : double

Esta propiedad contiene el valor máximo aceptable del validador

Por defecto, esta propiedad contiene un valor infinito.

Funciones de acceso:

double top() const
void setTop(double)

Véase también setRange().

Documentación de funciones de miembro

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

Crea un objeto validador con un objeto « parent » que acepta cualquier valor de tipo «double».

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

Crea un objeto validador a partir de un objeto ` parent `. Este validador aceptará valores de tipo `double` comprendidos entre ` bottom ` y ` top `, ambos inclusive, con hasta ` decimals ` decimales.

[virtual noexcept] QDoubleValidator::~QDoubleValidator()

Elimina el validador.

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

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

Intenta convertir la cadena de « input » en una representación « Acceptable » de un número de tipo «double».

El formato del número viene determinado por notation(), decimals(), locale() y la función numberOptions() de esta última.

Para cumplir con notation(), cuando se utiliza 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 se establece -1, el número de dígitos utilizados vendrá determinado por QLocale::FloatingPointShortest. De lo contrario, la parte fraccionaria del número se trunca (con redondeo, según corresponda) si su longitud supera decimals(). Cuando notation() se establece en ScientificNotation, esto se realiza después de que el número haya sido convertido a su forma normalizada.

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

Nota: Si decimals() está establecido en un valor superior a std::numeric_limits<double>::digits10 y la cadena proporciona más de ese número de dígitos, los dígitos de la parte fraccionaria que superen dicho número pueden modificarse. La cadena resultante codificará el mismo número de coma flotante cuando se analice en un double.

Esta función se introdujo en Qt 6.3.

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

Configura el validador para que acepte valores de tipo «double» comprendidos entre minimum y maximum, ambos inclusive, con un máximo de decimals dígitos después de la coma.

Nota: Al establecer el número de decimales en -1, se establece de hecho en ilimitado. Este es también el valor que utiliza un validador creado de forma predeterminada.

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

Configura el validador para que acepte valores de tipo «double» comprendidos entre minimum y maximum, ambos inclusive, sin modificar el número de decimales.

Se trata de una función sobrecargada.

[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 ` tiene el formato correcto y contiene un valor de tipo `double` dentro del rango válido.

Devuelve ` Intermediate ` si ` input ` tiene un formato incorrecto o contiene un valor de tipo `double` fuera del rango.

Devuelve « Invalid » si « input » no representa un número de tipo «double» o tiene demasiados dígitos después de la coma decimal.

Nota: Si el rango válido está formado únicamente por valores «double» positivos (por ejemplo, de 0,0 a 100,0) y « input » es un valor «double» negativo, se devuelve « Invalid ». Si « notation()» se establece en « StandardNotation » y la entrada contiene más dígitos antes del punto decimal de los que puede tener un valor «double» dentro del rango válido, se devuelve « Invalid ». Si notation() es ScientificNotation y la entrada no se encuentra dentro del rango válido, se devuelve Intermediate. El valor podría pasar a ser válido cambiando el exponente.

Por defecto, este validador no utiliza el parámetro « pos ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.