QValidator Class

Descripción detallada

La clase en sí es abstracta. Dos subclases, QIntValidator y QDoubleValidator, proporcionan una comprobación básica de rangos numéricos, y QRegularExpressionValidator proporciona una comprobación general utilizando una expresión regular personalizada.

Si los validadores incorporados no son suficientes, puedes subclasificar QValidator. La clase tiene dos funciones virtuales: validate() y fixup().

validate() debe ser implementada por cada subclase. Devuelve Invalid, Intermediate o Acceptable dependiendo de si su argumento es válido (para la definición de válido de la subclase).

Estos tres estados requieren alguna 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 (todavía se está editando). QValidator define Intermediate como la propiedad de una cadena que no es 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 entrada de una cadena Acceptable es Intermediate.

He aquí algunos ejemplos:

• Para una línea de edición que acepta números enteros del 10 al 1000 inclusive, 42 y 123 son Acceptable, la cadena vacía, 5, o 1234 son Intermediate, y "asdf" y 10114 es Invalid.
• Para un cuadro combinado editable que acepte URLs, cualquier URL bien formada es Acceptable, "http://example.com/," es Intermediate (podría ser una acción de cortar y pegar que accidentalmente llevó una coma al final), la cadena vacía es Intermediate (el usuario podría seleccionar y borrar todo el texto en preparación para introducir una nueva URL) y "http:///./" es Invalid.
• Para un cuadro de giro que acepte longitudes, "11cm" y "1in" son Acceptable, "11" y la cadena vacía son Intermediate, y "http://example.com" y "hour" son Invalid.

fixup() se proporciona para los validadores que pueden reparar algunos errores del usuario. La implementación por defecto no hace nada. QLineEdit Por ejemplo, fixup() si el usuario pulsa Intro (o Retorno) y el contenido no es válido en ese momento. Esto permite a la función fixup() la oportunidad de realizar algo de magia para hacer una cadena Invalid Acceptable .

Un validador tiene una configuración regional, establecida con setLocale(). Normalmente se utiliza para analizar datos localizados. Por ejemplo, QIntValidator y QDoubleValidator lo utilizan para analizar representaciones localizadas de enteros y dobles.

QValidator se utiliza normalmente con QLineEdit, QSpinBox y QComboBox.