QValidator Class

Description détaillée

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

Si les validateurs intégrés ne suffisent pas, vous pouvez créer une sous-classe de QValidator. La classe dispose 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 (selon la définition de « valide » de la sous-classe).

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

Voici quelques exemples :

• Pour un champ de saisie acceptant des nombres entiers compris entre 10 et 1 000 inclus, 42 et 123 sont des « Acceptable », la chaîne vide, 5 ou 1234 sont des « Intermediate », et «asdf» ainsi que 10114 sont des « Invalid ».
• Pour une liste déroulante modifiable acceptant les URL, toute URL bien formée est Acceptable; « http://example.com/ » est Intermediate (il peut s’agir d’un copier-coller ayant accidentellement conservé une virgule à la fin) ; la chaîne vide est Intermediate (l’utilisateur peut sélectionner et supprimer tout le texte avant de saisir une nouvelle URL) et « http:///./ » est Invalid.
• Pour une zone de sélection acceptant les longueurs, « 11 cm » et « 1 pouce » correspondent à Acceptable, « 11 » et la chaîne vide à Intermediate, et « http://example.com » et « heure » à Invalid.

fixupLa fonction () est fournie pour les validateurs capables de corriger certaines erreurs de l’utilisateur. L’implémentation par défaut ne fait rien. QLineEdit, par exemple, appellera fixup() si l’utilisateur appuie sur Entrée (ou Retour) et que le contenu n’est pas valide à ce moment-là. Cela permet à la fonction fixup() d’effectuer une transformation pour rendre une chaîne Invalid valide Acceptable.

Un validateur dispose d’une locale, définie à l’aide de ` setLocale()`. Elle est généralement utilisée pour analyser des données localisées. Par exemple, ` QIntValidator ` et ` QDoubleValidator ` s’en servent pour analyser les représentations localisées des entiers et des nombres à virgule flottante.

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