QValidator Class

Description détaillée

La classe elle-même est abstraite. Deux sous-classes, QIntValidator et QDoubleValidator, fournissent une vérification de base des plages numériques, et QRegularExpressionValidator fournit une vérification générale à l'aide d'une expression régulière personnalisée.

Si les validateurs intégrés ne sont pas suffisants, vous pouvez sous-classer QValidator. La classe possède deux fonctions virtuelles : validate() et fixup().

validate() doit être implémentée par chaque sous-classe. Elle renvoie Invalid, Intermediate ou Acceptable selon que son argument est valide ou non (pour la définition de valide de la sous-classe).

Ces trois états nécessitent quelques explications. Une chaîne Invalid est clairement invalide. Intermediate est moins évident : le concept de validité est difficile à appliquer lorsque la chaîne est incomplète (en cours d'édition). QValidator définit Intermediate comme la propriété d'une chaîne qui n'est ni clairement invalide, ni acceptable en tant que résultat final. Acceptable signifie que la chaîne est acceptable en tant que résultat final. On pourrait dire que toute chaîne qui est un état intermédiaire plausible lors de l'entrée d'une chaîne Acceptable est Intermediate.

Voici quelques exemples :

• Pour un éditeur de ligne qui accepte les nombres entiers de 10 à 1000 inclus, 42 et 123 sont Acceptable, la chaîne vide, 5 ou 1234 sont Intermediate, et "asdf" et 10114 sont Invalid.
• Pour une liste déroulante éditable qui accepte les URL, toute URL bien formée est Acceptable, "http://example.com/" est Intermediate (il peut s'agir d'un copier-coller qui a accidentellement inséré une virgule à la fin), la chaîne vide est Intermediate (l'utilisateur peut sélectionner et supprimer tout le texte en vue de saisir un nouvel URL) et "http:///./" est Invalid.
• Pour une boîte à outils qui accepte les longueurs, "11cm" et "1in" sont Acceptable, "11" et la chaîne vide sont Intermediate, et "http://example.com" et "hour" sont Invalid.

fixup() est fourni pour les validateurs qui peuvent réparer certaines erreurs de l'utilisateur. L'implémentation par défaut ne fait rien. QLineEdit Par exemple, la fonction fixup() est appelée si l'utilisateur appuie sur Entrée (ou Retour) et que le contenu n'est pas valide. Cela permet à la fonction fixup() d'opérer une certaine magie pour rendre une chaîne Invalid Acceptable .

Un validateur possède une locale, définie avec setLocale(). Il est généralement utilisé pour analyser des données localisées. Par exemple, QIntValidator et QDoubleValidator l'utilisent pour analyser les représentations localisées des entiers et des doubles.

QValidator est généralement utilisé avec QLineEdit, QSpinBox et QComboBox.