QDoubleValidator Class

Documentation des fonctions membres

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

Construit un objet validateur avec un objet parent qui accepte n'importe quel double.

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

Construit un objet validateur avec un objet parent. Ce validateur accepte les doubles de bottom à top inclus, avec un maximum de decimals chiffres après la virgule.

[virtual noexcept] QDoubleValidator::~QDoubleValidator()

Détruit le validateur.

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

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

Tente de fixer la chaîne input à une représentation Acceptable d'un double.

Le format du nombre est déterminé par notation(), decimals(), locale() et numberOptions().

Pour se conformer à notation(), lorsque ScientificNotation est utilisé, la valeur fixe sera représentée sous sa forme normalisée, ce qui signifie que toute valeur non nulle aura 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(), lorsqu'il s'agit de -1, 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 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 doubles de minimum à maximum inclus, avec un maximum de decimals chiffres après la virgule.

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

Configure le validateur pour qu'il accepte les doubles de minimum à 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 bon format et contient un double dans la plage valide.

Renvoie Intermediate si input n'est pas au bon format ou contient un double en dehors de la plage.

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

Remarque : si la plage valide ne comprend que des doubles positifs (par exemple, de 0,0 à 100,0) et que input est un double négatif, Invalid est renvoyé. Si notation() est égal à StandardNotation et que l'entrée contient plus de chiffres avant la virgule qu'un double de la plage valide ne peut en avoir, Invalid est renvoyé. Si notation() est égal à ScientificNotation, et que l'entrée n'est pas dans la plage valide, Intermediate est renvoyé. La valeur peut encore devenir valide en changeant l'exposant.

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