Developpez.com - Qt
X

Choisissez d'abord la catégorieensuite la rubrique :

Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
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 !

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 59
  2. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  3. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  4. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  5. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. La rubrique Qt a besoin de vous ! 1
Page suivante

Le Qt Quarterly au hasard

Logo

Générer du XML

Qt Quarterly est la revue trimestrielle proposée par Nokia et à destination des développeurs Qt. Ces articles d'une grande qualité technique sont rédigés par des experts Qt. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

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 © 2012 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 ? Un bug ? 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 !
 
 
 
 
Partenaires

Hébergement Web

Responsable bénévole de la rubrique Qt : Thibaut Cuvelier -