QDoubleValidator Class

Documentation sur les fonctions membres

[explicit] QDoubleValidator::QDoubleValidator(QObject *parent = nullptr)

Crée un objet validateur à partir d'un objet « parent » qui accepte n'importe quelle valeur de type double.

QDoubleValidator::QDoubleValidator(double bottom, double top, int decimals, QObject *parent = nullptr)

Crée un objet validateur à partir d'un objet « parent ». Ce validateur acceptera les valeurs de type double comprises entre bottom et top inclus, avec jusqu'à decimals chiffres après la virgule.

[virtual noexcept] QDoubleValidator::~QDoubleValidator()

Supprime le validateur.

[override virtual, since 6.3] void QDoubleValidator::fixup(QString &input) const

Réimplémente : QValidator::fixup(QString &input) const.

Tente de convertir la chaîne « input » en une représentation « Acceptable » d'un nombre de type double.

Le format du nombre est déterminé par les fonctions notation(), decimals(), locale() et numberOptions() de cette dernière.

Pour se conformer à la norme notation(), lorsque la fonction ScientificNotation est utilisée, la valeur fixe sera représentée sous sa forme normalisée, ce qui signifie que toute valeur non nulle comportera un chiffre non nul avant la virgule.

QString input = "0.98765e2";
QDoubleValidator val;
val.setLocale(QLocale::C);
val.setNotation(QDoubleValidator::ScientificNotation);
val.fixup(input); // input == "9.8765e+01"

Pour se conformer à ` decimals()`, lorsque ` -1 ` est utilisé, le nombre de chiffres utilisés sera déterminé par ` QLocale::FloatingPointShortest`. Sinon, la partie fractionnaire du nombre est tronquée (avec arrondi, le cas échéant) si sa longueur dépasse ` decimals()`. Lorsque ` notation()` est défini sur ` ScientificNotation `, cette opération est effectuée après que le nombre a été mis sous sa forme normalisée.

input = "-1234.6789";
val.setDecimals(2);
val.setLocale(QLocale::C);
val.setNotation(QDoubleValidator::StandardNotation);
val.fixup(input); // input == "-1234.68"

Cette fonction a été introduite dans Qt 6.3.

void QDoubleValidator::setRange(double minimum, double maximum, int decimals)

Configure le validateur pour qu'il accepte les nombres de type double compris entre minimum et maximum inclus, avec au maximum decimals chiffres après la virgule.

void QDoubleValidator::setRange(double minimum, double maximum)

Configure le validateur pour qu'il accepte les nombres de type double compris entre minimum et maximum inclus, sans modifier le nombre de chiffres après la virgule.

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

Réimplémente : QValidator::validate(QString &input, int &pos) const.

Renvoie ` Acceptable ` si la chaîne ` input ` est au format correct et contient un nombre de type `double` compris dans l'intervalle valide.

Renvoie ` Intermediate ` si ` input ` n'est pas au bon format ou contient une valeur de type `double` hors de cette plage.

Renvoie « Invalid » si la chaîne « input » ne représente pas un nombre double ou comporte trop de chiffres après la virgule.

Remarque : si l'intervalle valide ne comprend que des nombres doubles positifs (par exemple, de 0,0 à 100,0) et que ` input ` est un nombre double négatif, alors ` Invalid ` est renvoyé. Si ` notation()` est défini sur ` StandardNotation` et que l'entrée contient plus de chiffres avant la virgule décimale qu'un nombre double de l'intervalle valide ne peut en avoir, ` Invalid ` est renvoyé. Si notation() est défini sur ScientificNotation et que la valeur saisie ne se trouve pas dans la plage valide, Intermediate est renvoyée. La valeur peut toutefois devenir valide en modifiant l’exposant.

Par défaut, le paramètre pos n’est pas utilisé par ce validateur.