Vous devez avoir un compte Developpez.com et être connecté pour pouvoir participer aux discussions.

Identifiez-vous
Identifiant
Mot de passe
Mot de passe oublié ?
Créer un compte

Vous n'avez pas encore de compte Developpez.com ? L'inscription est gratuite et ne vous prendra que quelques instants !

Je m'inscris !

Developpez.com

Qt

Choisissez la catégorie, puis la rubrique :

Viadeo Twitter Facebook Share on Google+   
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

QValidator

La classe QValidator fournit la validation de champs de texte. Plus d'informations...

#include <QValidator>

Voir la position dans l'arbre des classes.

  

Héritage

Hérite de QObject.

Hérité par QDoubleValidator, QIntValidator et QRegExpValidator.

Description détaillée

La classe QValidator fournit la validation de champs de texte.

La classe elle-même est abstraite. Deux sous-classes, QIntValidator et QDoubleValidator, fournissent la vérification de gammes numériques. QRegExpValidator fournit la vérification générale en utilisant les expressions régulières.

Si les validateurs fournis ne vous suffisent pas, vous pouvez dériver votre propre sous-classe de QValidator. La classe a deux fonctions virtuelles : validate() et fixup().

La fonction validate() doit être implémentée par toutes les sous-classes et retourner une des valeurs de l'énumération State (Invalid, Intermediate ou Acceptable) selon la validité de l'argument (pour la définition de la sous-classe de validité).

Ces trois états nécessitent quelques explications. Une chaîne de caractères qui retourne Invalid est clairement invalide. L'état Intermediate est moins évident : la notion de validité est difficile à appliquer quand la chaîne de caractères est incomplète (toujours en cours d'édition). QValidator définit Intermediate comme la propriété d'une chaîne de caractères qui n'est pas manifestement invalide, mais pas non plus acceptable comme résultat final. L'état Acceptable signifique que la chaîne est acceptable comme résultat final. On pourrait dire que toute chaîne de caractères qui est un dans l'état intermédiaire lors de l'entrée d'une chaîne de caractères Acceptable est Intermediate.

Quelques exemples :

  • Pour une ligne d'édition qui accepte les entiers de 10 à 1000 inclus, 42 et 123 sont Acceptable, une chaîne de caractères vide et 5 sont Intermediate, et « asdf » et 1114 sont Invalid ;
  • Pour une liste déroulante éditable qui accepte des URL, toutes les URL bien formées sont Acceptable, « http://example.com/, » est Intermediate (elle peut être copiée et collée en ayant pris accidentellement une virgule à la fin), une chaîne de caractères vide est Intermediate (l'utilisateur peut sélectionner et supprimer tout le texte en préparation pour entrer une nouvelle URL) et « http:///./ » est invalide ;
  • Pour une spin box qui accepte des tailles, « 11cm » et « 1km » sont Acceptable, « 11 » et une chaîne de caractères vide sont Intermediate, et « http://example.com » et « heure » sont Invalid.

La fonction fixup() est fournie pour les validateurs qui peuvent repérer certaines des erreurs de l'utilisateur. L'implémentation par défaut est vide. Un QLineEdit, par exemple, appellera fixup() si l'utilisateur presse Entrée (ou Retour) et si le contenu est actuellement invalide. Cela permet à la fonction fixup() de transformer une chaîne de caractères Invalid en une chaîne Acceptable.

Un validateur a un concept de localisation, défini avec setlocale(). Il est généralement utilisé pour analyser des données localisées. Par exemple, QIntValidator et QDoubleValidator l'utilise pour analyser les représentations localisées des nombres entiers et doubles.

QValidator est souvent utilisé avec QLineEdit, QSpinBox et QComboBox.

Voir aussi QIntValidator, QDoubleValidator, QRegExpValidator et l'exemple des lignes d'édition.

Type

enum QValidator::State

Cette énumération définit les états qu'une chaîne de caractères validée peut avoir.

Constante Valeur Description
QValidator::Invalid 0 La chaîne est clairement invalide.
QValidator::Intermediate 1 La chaîne a une valeur intermédiaire plausible.
QValidator::Acceptable 2 La chaîne est acceptable comme un résultat final, c'est-à-dire valide.

Fonctions membres

QValidator::QValidator ( QObject * parent = 0 )

Construit le validateur. Le paramètre parent est passé au constructeur de QObject.

QValidator::~QValidator ()

Détruit le validateur, libère tout l'espace et autres ressources utilisées.

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

Cette fonction tente de changer input pour être valide selon les règles du validateur. Elle ne doit pas aboutir à une chaîne de caractères valide : les appelants de cette fonction doivent la re-tester par la suite. La fonction ne fait rien par défaut.

Les réimplémentations de cette fonction peuvent changer input même si elles ne produisent pas de chaînes de caractères valide. Par exemple, un validateur ISBN peut vouloir supprimer tous les caractères exceptés les nombres et  »- », même si le résultat n'est pas un ISBN valide ; un validateur de surnoms peut vouloir supprimer les espaces au début et à la fin de la chaîne de caractères, même si la chaîne résultante n'est pas dans la liste des surnoms acceptés.

QLocale QValidator::locale () const

Retourne la localisation utilisée pour le validateur. La localisation par défaut est initialisée à la même que QLocale().

Voir aussi setLocale() et QLocale::QLocale().

void QValidator::setLocale ( const QLocale & locale )

Définit la localisation qui sera utilisée par le validateur. À moins que setLocale ait été appelée, le validateur va utiliser la localisation, par défaut mise à QLocale::setDefault(). Si la localisation par défaut n'a pas été définie, c'est la localisation du système d'exploitation qui sera utilisée.

Voir aussi locale() et QLocale::setDefault().

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

Cette fonction virtuelle retourne Invalid si input n'est pas valide selon les règles de ce validateur, Intermediate s'il est probable qu'avec un petit peu plus d'édition, l'entrée sera acceptable (par exemple, l'utilisateur tape « 4 » dans un widget qui accepte des entiers entre 10 et 99) et Acceptable si l'entrée est valide.

Cette fonction peut changer les deux arguments input et pos (la position du curseur) si nécessaire.

Remerciements

Merci à Adrien Dadouchi pour la traduction et à Jonathan Courtois, Thibaut Cuvelier et à Jacques Thery pour leur relecture !

Warning: include(): https:// wrapper is disabled in the server configuration by allow_url_include=0 in /home/developpez/www/developpez-com/upload/qt/doc/bs.php on line 4 Warning: include(https://qt.developpez.com/index/rightColumn): failed to open stream: no suitable wrapper could be found in /home/developpez/www/developpez-com/upload/qt/doc/bs.php on line 4 Warning: include(): Failed opening 'https://qt.developpez.com/index/rightColumn' for inclusion (include_path='.:/usr/php53/lib/php') in /home/developpez/www/developpez-com/upload/qt/doc/bs.php on line 4
Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.7
Copyright © 2020 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur, une redirection cassée ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
Responsable bénévole de la rubrique Qt : Thibaut Cuvelier -

Partenaire : Hébergement Web