Sur cette page

DoubleValidator QML Type

Définit un validateur pour les nombres non entiers. En savoir plus...

Import Statement: import QtQuick
In C++: QDoubleValidator

Propriétés

Description détaillée

Le type DoubleValidator fournit un validateur pour les nombres non entiers.

  • Entrée acceptée : l'entrée est acceptée si elle contient un nombre à virgule flottante (double) compris dans la plage valide et au format correct.
  • Entrée acceptée mais non valide : l'entrée est acceptée mais considérée comme non valide si elle contient une valeur de type double qui se trouve en dehors de la plage valide ou qui est au format incorrect (par exemple, trop de chiffres après la virgule décimale ou vide).
  • Entrée rejetée : l'entrée est rejetée si elle n'est pas de type double.

Remarque : si la plage valide ne comprend que des nombres doubles positifs (par exemple, de 0,0 à 100,0) et que la valeur saisie est un nombre double négatif, elle est rejetée. Si la valeur de « notation » est définie sur « DoubleValidator.StandardNotation » et que la valeur saisie contient plus de chiffres avant la virgule décimale qu’un nombre double de la plage valide ne peut en avoir, elle est également rejetée. Si ` notation ` est défini sur ` DoubleValidator.ScientificNotation ` et que la valeur saisie ne se trouve pas dans la plage valide, elle est acceptée mais considérée comme non valide. La valeur peut devenir valide en modifiant l’exposant.

L'exemple suivant montre un objet ` TextInput ` avec un `DoubleValidator` permettant de vérifier que l'utilisateur a saisi un nombre de type `double` dans la plage spécifiée, en mettant en évidence la couleur du texte pour signaler une saisie non valide :

import QtQuick

TextInput {
    focus: true
    validator: DoubleValidator {
        bottom: 0.00
        top: 100.00
        decimals: 2
        notation: DoubleValidator.StandardNotation
    }
    onAcceptableInputChanged:
        color = acceptableInput ? "black" : "red";
}

Voir également IntValidator, RegularExpressionValidator et Validation du texte saisi.

Documentation sur les propriétés

bottom : real

Cette propriété contient la valeur minimale acceptable du validateur. Par défaut, cette propriété prend la valeur -infini.

decimals : int

Cette propriété indique le nombre maximal de chiffres après la virgule autorisé par le validateur. Par défaut, cette propriété prend la valeur 1 000.

locale : string

Cette propriété contient le nom des paramètres régionaux utilisés pour interpréter le nombre.

Voir aussi Qt.locale().

notation : enumeration

Cette propriété définit la notation permettant à une chaîne de caractères de représenter un nombre.

Les valeurs possibles pour cette propriété sont les suivantes :

ConstanteDescription
DoubleValidator.StandardNotationuniquement des nombres décimaux avec signe facultatif (par exemple : -0.015)
DoubleValidator.ScientificNotation(par défaut) le nombre écrit peut comporter une partie exponentielle (par exemple : 1.5E-2)

top : real

Cette propriété contient la valeur maximale acceptable pour le validateur. Par défaut, cette propriété prend la valeur « infini ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.