Editeur de texte Qt de saisie de double. - * Le nombre de décimales est fixé par défaut à 8.
+ *Editeur de texte Qt de saisie de double. Le nombre de décimales est fixé par défaut à 8.
* - *A partir de la version 2.42.0 de cette bibliothèque la validation - * automatique peut être désactivée lors de la perte de focus ou frappe d'une - * touche. + *
A partir de la version 2.42.0 de cette bibliothèque la validation automatique peut être désactivée lors de la perte de focus ou frappe d'une touche. *
*/ class QtDoubleTextField : public QtValidatedTextField @@ -22,8 +19,7 @@ class QtDoubleTextField : public QtValidatedTextField /** Constructeur. * @param widget parent. - * @param true s'il faut procéder à une validation automatique - * lors de la perte de focus ou d'une frappe clavier. + * @param true s'il faut procéder à une validation automatique lors de la perte de focus ou d'une frappe clavier. * @param nom du widget. */ QtDoubleTextField ( @@ -32,21 +28,14 @@ class QtDoubleTextField : public QtValidatedTextField /** Constructeur. * @param valeur initiale. * @param widget parent. - * @param true s'il faut procéder à une validation automatique - * lors de la perte de focus ou d'une frappe clavier. + * @param true s'il faut procéder à une validation automatique lors de la perte de focus ou d'une frappe clavier. * @param nom du widget. - * @warning ATTENTION : transmettre les valeurs initiales non pas - * via le constructeur, mais via une méthode setX (ex : - * setValue). En effet, le validateur n'étant pas - * construit, le texte initial peut être jugé invalide pour des - * questions de formatage (nombre de décimales trop important - * par exemple). Une fois le validateur construit un appel à - * setX prend en compte ces aspects formatage et la - * valeur affichée est valide. + * @warning ATTENTION : transmettre les valeurs initiales non pas via le constructeur, mais via une méthode setX (ex : + * setValue). En effet, le validateur n'étant pas construit, le texte initial peut être jugé invalide pour des + * questions de formatage (nombre de décimales trop important par exemple). Une fois le validateur construit un appel à + * setX prend en compte ces aspects formatage et la valeur affichée est valide. */ - QtDoubleTextField ( - double value, QWidget* parent, bool autoValidation = false, - const char* name = 0); + QtDoubleTextField (double value, QWidget* parent, bool autoValidation = false, const char* name = 0); /** Destructeur. */ @@ -122,10 +111,8 @@ class QtDoubleTextField : public QtValidatedTextField virtual QDoubleValidator* cloneValidator ( ); /** - * Valide le contenu du champ de texte. En cas d'erreur affiche un message - * d'erreur. Ne lève pas d'exception. - * @return true si le champ de texte est valide, false dans le cas - * contraire. + * Valide le contenu du champ de texte. En cas d'erreur affiche un message d'erreur. Ne lève pas d'exception. + * @return true si le champ de texte est valide, false dans le cas contraire. */ virtual bool validate ( ); diff --git a/src/QtUtil/public/QtUtil/QtIntTextField.h b/src/QtUtil/public/QtUtil/QtIntTextField.h index e50cfac..6d6de94 100644 --- a/src/QtUtil/public/QtUtil/QtIntTextField.h +++ b/src/QtUtil/public/QtUtil/QtIntTextField.h @@ -10,9 +10,7 @@ class QIntValidator; /** *Editeur de texte Qt de saisie de int.
* - *A partir de la version 2.42.0 de cette bibliothèque la validation - * automatique peut être désactivée lors de la perte de focus ou frappe d'une - * touche. + *
A partir de la version 2.42.0 de cette bibliothèque la validation automatique peut être désactivée lors de la perte de focus ou frappe d'une touche. *
*/ class QtIntTextField : public QtValidatedTextField @@ -21,8 +19,7 @@ class QtIntTextField : public QtValidatedTextField /** Constructeur. * @param widget parent. - * @param true s'il faut procéder à une validation automatique - * lors de la perte de focus ou d'une frappe clavier. + * @param true s'il faut procéder à une validation automatique lors de la perte de focus ou d'une frappe clavier. * @param nom du widget. */ QtIntTextField ( @@ -31,21 +28,14 @@ class QtIntTextField : public QtValidatedTextField /** Constructeur. * @param valeur initiale. * @param widget parent. - * @param true s'il faut procéder à une validation automatique - * lors de la perte de focus ou d'une frappe clavier. + * @param true s'il faut procéder à une validation automatique lors de la perte de focus ou d'une frappe clavier. * @param nom du widget. - * @warning ATTENTION : transmettre les valeurs initiales non pas - * via le constructeur, mais via une méthode setX (ex : - * setValue). En effet, le validateur n'étant pas - * construit, le texte initial peut être jugé invalide pour des - * questions de formatage (nombre de décimales trop important - * par exemple). Une fois le validateur construit un appel à - * setX prend en compte ces aspects formatage et la - * valeur affichée est valide. + * @warning ATTENTION : transmettre les valeurs initiales non pas via le constructeur, mais via une méthode setX (ex : + * setValue). En effet, le validateur n'étant pas construit, le texte initial peut être jugé invalide pour des + * questions de formatage (nombre de décimales trop important par exemple). Une fois le validateur construit un appel à + * setX prend en compte ces aspects formatage et la valeur affichée est valide. */ - QtIntTextField( - int value, QWidget* parent, bool autoValidate = false, - const char* name = 0); + QtIntTextField(int value, QWidget* parent, bool autoValidate = false, const char* name = 0); /** Destructeur. */ @@ -96,10 +86,8 @@ class QtIntTextField : public QtValidatedTextField const virtual QIntValidator& getValidator ( ) const; /** - * Valide le contenu du champ de texte. En cas d'erreur affiche un message - * d'erreur. Ne lève pas d'exception. - * @return true si le champ de texte est valide, false dans le cas - * contraire. + * Valide le contenu du champ de texte. En cas d'erreur affiche un message d'erreur. Ne lève pas d'exception. + * @return true si le champ de texte est valide, false dans le cas contraire. */ virtual bool validate ( ); diff --git a/src/QtUtil/public/QtUtil/QtTextField.h b/src/QtUtil/public/QtUtil/QtTextField.h index 8733bad..579bf43 100644 --- a/src/QtUtil/public/QtUtil/QtTextField.h +++ b/src/QtUtil/public/QtUtil/QtTextField.h @@ -8,8 +8,7 @@ /** - * Editeur de texte Qt offrant davantage de possibilités que la classe - * QLineEdit. + * Editeur de texte Qt offrant davantage de possibilités que la classe QLineEdit. */ class QtTextField : public QLineEdit { @@ -51,19 +50,15 @@ class QtTextField : public QLineEdit virtual void setVisibleColumns (int count); /** - * @return Les largeurs/hauteurs correspondant au nombre de caractères - * visibles demandés. En l'absence de demande spécifique, via - * setVisibleColumns, retourne QLineEdit::sizeHint ( ) - * (ce qui correspond à une largeur d'environ 17 caractères). - * Si le champ de texte a du texte prend la taille des maxLength ( ) - * premiers caractères. + * @return Les largeurs/hauteurs correspondant au nombre de caractères visibles demandés. En l'absence de demande spécifique, via + * setVisibleColumns, retourne QLineEdit::sizeHint ( ) (ce qui correspond à une largeur d'environ 17 caractères). + * Si le champ de texte a du texte prend la taille des maxLength ( ) premiers caractères. * @see isNumeric */ virtual QSize sizeHint ( ) const; /** - * @return true si le champ contient des valeurs numériques, - * false dans le cas contraire. Retourne false + * @return true si le champ contient des valeurs numériques, false dans le cas contraire. Retourne false * par défaut, méthode à surcharger si nécessaire. * Utile pour sizeHint. * @see sizeHint diff --git a/src/QtUtil/public/QtUtil/QtValidatedTextField.h b/src/QtUtil/public/QtUtil/QtValidatedTextField.h index f989a53..78f1658 100644 --- a/src/QtUtil/public/QtUtil/QtValidatedTextField.h +++ b/src/QtUtil/public/QtUtil/QtValidatedTextField.h @@ -8,23 +8,17 @@ class QValidatedValidator; /** - *Classe abstraite de saisie de texte mono-ligne avec validation par une - * instance de QValidator. La validation est automatiquement effectuée - * lors de la perte du focus ou lorsque l'utilisateur enfonce la touche - * "return". + *
Classe abstraite de saisie de texte mono-ligne avec validation par une instance de QValidator. La validation est automatiquement effectuée + * lors de la perte du focus ou lorsque l'utilisateur enfonce la touche "return". *
* *- * IMPORTANT : pour bénéficier des services de cette classe, les classes - * dérivées doivent impérativement associer à l'instance une instance d'une - * classe dérivée de QValidator. Cette classe personnalise les messages - * d'erreurs pour des validateurs de types QIntValidator, + * IMPORTANT : pour bénéficier des services de cette classe, les classes dérivées doivent impérativement associer à l'instance une instance d'une + * classe dérivée de QValidator. Cette classe personnalise les messages d'erreurs pour des validateurs de types QIntValidator, * QDoubleValidator et QRegExpValidator. *
* - *A partir de la version 2.42.0 de cette bibliothèque la validation - * automatique peut être désactivée lors de la perte de focus ou frappe d'une - * touche. + *
A partir de la version 2.42.0 de cette bibliothèque la validation automatique peut être désactivée lors de la perte de focus ou frappe d'une touche. *
* * @see QtDoubleTextField @@ -40,8 +34,7 @@ class QtValidatedTextField : public QtTextField virtual ~QtValidatedTextField ( ); /** - *Si true ou si automaticValidation ( ) retourne - * true provoque alors la validation automatique du champ de texte + *
Si true ou si automaticValidation ( ) retourne true provoque alors la validation automatique du champ de texte * lors de la perte du focus ou d'une frappe clavier.
* *Vaut true par défaut.
@@ -49,15 +42,13 @@ class QtValidatedTextField : public QtTextField static bool automaticValidation; /** - *Si true une erreur lors de la validation provoque l'affichage - * d'une boite de dialogue. + *
Si true une erreur lors de la validation provoque l'affichage d'une boite de dialogue. * *
Vaut true par défaut.
*/ static bool dialogOnError; - /** Couleurs utilisées lorsque la saisie est invalide (blanc pour le fond, - * rouge pour le texte par défaut). + /** Couleurs utilisées lorsque la saisie est invalide (blanc pour le fond, rouge pour le texte par défaut). */ static QColor errorBackground, errorForeground; @@ -66,37 +57,25 @@ class QtValidatedTextField : public QtTextField /** Constructeur. * @param widget parent. - * @param true s'il faut procéder à une validation automatique - * lors de la perte de focus ou d'une frappe clavier. + * @param true s'il faut procéder à une validation automatique lors de la perte de focus ou d'une frappe clavier. * @param nom du widget. - * @warning ATTENTION : transmettre les valeurs initiales non pas - * via le constructeur, mais via une méthode setX (ex : - * setValue). En effet, le validateur n'étant pas - * construit, le texte initial peut être jugé invalide pour des - * questions de formatage (nombre de décimales trop important - * par exemple). Une fois le validateur construit un appel à - * setX prend en compte ces aspects formatage et la - * valeur affichée est valide. + * @warning ATTENTION : transmettre les valeurs initiales non pas via le constructeur, mais via une méthode setX (ex : + * setValue). En effet, le validateur n'étant pas construit, le texte initial peut être jugé invalide pour des + * questions de formatage (nombre de décimales trop important par exemple). Une fois le validateur construit un appel à + * setX prend en compte ces aspects formatage et la valeur affichée est valide. */ - QtValidatedTextField ( - QWidget* parent, bool autoValidate = false, const char* name = 0); + QtValidatedTextField (QWidget* parent, bool autoValidate = false, const char* name = 0); /** - * @return true si le widget procède à une autovalidation en cas - * de perte de focus ou de frappe clavier, false dans - * le cas contraire. - * @warning La variable de classe automaticValidation est - * également prise en compte. + * @return true si le widget procède à une autovalidation en cas de perte de focus ou de frappe clavier, false dans le cas contraire. + * @warning La variable de classe automaticValidation est également prise en compte. */ virtual bool doAutoValidation ( ) const { return _autoValidation; } /** - * @param true si le widget doit procéder à une autovalidation - * en cas de perte de focus ou de frappe clavier, false - * dans le cas contraire. - * @warning La variable de classe automaticValidation est - * également prise en compte. + * @param true si le widget doit procéder à une autovalidation en cas de perte de focus ou de frappe clavier, false dans le cas contraire. + * @warning La variable de classe automaticValidation est également prise en compte. */ virtual void doAutoValidation (bool autoValidation) { _autoValidation = autoValidation; } @@ -109,25 +88,21 @@ class QtValidatedTextField : public QtTextField virtual void focusInEvent (QFocusEvent* event); /** - * Invoqué lors de la perte du focus : effectue une vérification des - * données saisies et affiche un message en cas d'erreur. + * Invoqué lors de la perte du focus : effectue une vérification des données saisies et affiche un message en cas d'erreur. * @see validate */ virtual void focusOutEvent (QFocusEvent* event); /** - * Invoqué lorsqu'une touche a été pressée : effectue une vérification des - * données saisies et affiche un message en cas d'erreur. + * Invoqué lorsqu'une touche a été pressée : effectue une vérification des données saisies et affiche un message en cas d'erreur. * @see validate */ virtual void keyPressEvent (QKeyEvent* event); /** - * Valide le contenu du champ de texte. En cas d'erreur affiche un message - * d'erreur si dialogOnError vaut true, et modifie l'aspect + * Valide le contenu du champ de texte. En cas d'erreur affiche un message d'erreur si dialogOnError vaut true, et modifie l'aspect * du champ de saisie. Ne lève pas d'exception. - * @return true si le champ de texte est valide, false dans le cas - * contraire. + * @return true si le champ de texte est valide, false dans le cas contraire. * @see setSkin * @see dialogOnError * @see errorBackground @@ -136,8 +111,7 @@ class QtValidatedTextField : public QtTextField virtual bool validate ( ); /** - * Modifie l'apparence du champ de saisie (true : apparence normale, - * false : apparence en erreur). + * Modifie l'apparence du champ de saisie (true : apparence normale, false : apparence en erreur). * @see validate * @see errorBackground * @see errorForeground diff --git a/versions.txt b/versions.txt index 417df81..4c19dda 100644 --- a/versions.txt +++ b/versions.txt @@ -1,3 +1,9 @@ +Version 6.4.1 : 23/02/24 +=============== + +Correctif Qt*TextField::setRange (T min, T max) : min == max accepté. + + Version 6.4.0 : 13/12/23 ===============