En esta página

QValidator Class

La clase QValidator permite validar el texto introducido. Más información...

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

QDoubleValidator, ` QIntValidator` y QRegularExpressionValidator

Tipos públicos

enum State { Invalid, Intermediate, Acceptable }

Funciones públicas

QValidator(QObject *parent = nullptr)
virtual ~QValidator()
virtual void fixup(QString &input) const
QLocale locale() const
void setLocale(const QLocale &locale)
virtual QValidator::State validate(QString &input, int &pos) const = 0

Señales

void changed()

Descripción detallada

La clase en sí es abstracta. Dos subclases, ` QIntValidator ` y ` QDoubleValidator`, proporcionan una comprobación básica del rango numérico, y ` QRegularExpressionValidator ` ofrece una comprobación general mediante una expresión regular personalizada.

Si los validadores integrados no son suficientes, puedes crear una subclase de QValidator. La clase tiene dos funciones virtuales: validate() y fixup().

validate() debe ser implementada por todas las subclases. Devuelve Invalid, Intermediate o Acceptable, dependiendo de si su argumento es válido (según la definición de «válido» de la subclase).

Estos tres estados requieren cierta explicación. Una cadena « Invalid » es claramente inválida. « Intermediate » es menos obvio: el concepto de validez es difícil de aplicar cuando la cadena está incompleta (aún se está editando). QValidator define « Intermediate » como la propiedad de una cadena que no es ni claramente inválida ni aceptable como resultado final. « Acceptable » significa que la cadena es aceptable como resultado final. Se podría decir que cualquier cadena que sea un estado intermedio plausible durante la introducción de una cadena « Acceptable » es « Intermediate ».

He aquí algunos ejemplos:

  • En el caso de un campo de edición de línea que acepta números enteros del 10 al 1000, ambos inclusive, 42 y 123 son Acceptable; la cadena vacía, 5 o 1234 son Intermediate; y «asdf» y 10114 son Invalid.
  • En el caso de un cuadro combinado editable que admita URL, cualquier URL bien formada es Acceptable; «http://example.com/» es Intermediate (podría tratarse de una acción de copiar y pegar en la que se haya incluido accidentalmente una coma al final); la cadena vacía es Intermediate (el usuario podría haber seleccionado y borrado todo el texto para introducir una nueva URL) y «http:///./» es Invalid.
  • En el caso de un cuadro de selección que admita longitudes, «11 cm» y «1 pulgada» son Acceptable, «11» y la cadena vacía son Intermediate, y «http://example.com» y «hora» son Invalid.

fixupSe proporciona () para los validadores que pueden corregir algunos errores del usuario. La implementación por defecto no hace nada. QLineEdit, por ejemplo, llamará a fixup() si el usuario pulsa Intro (o Retorno) y el contenido no es válido en ese momento. Esto permite que la función fixup() pueda hacer «magia» para convertir una cadena Invalid en Acceptable.

Un validador tiene una configuración regional, que se establece con setLocale(). Normalmente se utiliza para analizar datos localizados. Por ejemplo, QIntValidator y QDoubleValidator la utilizan para analizar representaciones localizadas de enteros y números de tipo double.

QValidator se suele utilizar con QLineEdit, QSpinBox y QComboBox.

Véase también QIntValidator, QDoubleValidator, QRegularExpressionValidator y el ejemplo de campos de edición de línea.

Documentación sobre los tipos de miembro

enum QValidator::State

Este tipo de enumeración define los estados en los que puede encontrarse una cadena validada.

ConstanteValorDescripción
QValidator::Invalid0La cadena es claramente inválida.
QValidator::Intermediate1La cadena es un valor intermedio plausible.
QValidator::Acceptable2La cadena es aceptable como resultado final; es decir, es válida.

Documentación de funciones de miembro

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

Configura el validador. El parámetro « parent » se pasa al constructor « QObject ».

[virtual noexcept] QValidator::~QValidator()

Elimina el validador, liberando el espacio de almacenamiento y los demás recursos utilizados.

[signal] void QValidator::changed()

Esta señal se emite cuando cambia cualquier propiedad que pueda afectar a la validez de una cadena de caracteres.

[virtual] void QValidator::fixup(QString &input) const

Esta función intenta modificar input para que sea válida según las reglas de este validador. No es necesario que el resultado sea una cadena válida: quienes llamen a esta función deben volver a comprobarla posteriormente; por defecto, no realiza ninguna acción.

Las reimplementaciones de esta función pueden modificar input aunque no generen una cadena válida. Por ejemplo, un validador de ISBN podría querer eliminar todos los caracteres excepto los dígitos y el carácter «-», aunque el resultado siga sin ser un ISBN válido; un validador de apellidos podría querer eliminar los espacios en blanco del principio y del final de la cadena, aunque la cadena resultante no figure en la lista de apellidos aceptados.

QLocale QValidator::locale() const

Devuelve la configuración regional del validador. Por defecto, la configuración regional se inicializa con el mismo valor que QLocale().

Véase también setLocale() y QLocale::QLocale().

void QValidator::setLocale(const QLocale &locale)

Establece la configuración regional ( locale ) que se utilizará para el validador. A menos que se haya llamado a la función `setLocale`, el validador utilizará la configuración regional predeterminada establecida con ` QLocale::setDefault()`. Si no se ha establecido ninguna configuración regional predeterminada, se utilizará la del sistema operativo.

Véanse también locale() y QLocale::setDefault().

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

Esta función virtual devuelve Invalid si input no es válido según las reglas de este validador, Intermediate si es probable que con unos pequeños ajustes la entrada resulte aceptable (por ejemplo, el usuario escribe «4» en un widget que admite números enteros entre 10 y 99), y Acceptable si la entrada es válida.

La función puede modificar tanto input como pos (la posición del cursor) si es necesario.

© 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.