IntValidator QML Type

Définit un validateur pour les valeurs entières. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• bottom : int
• locale : string
• top : int

Description détaillée

Le type IntValidator fournit un validateur pour les valeurs entières.

Si aucun objet ` locale ` n’est défini, `IntValidator` utilise le paramètre ` default locale ` pour interpréter le nombre et accepte les chiffres, les séparateurs de groupes et les signes positifs et négatifs spécifiques à la locale. De plus, `IntValidator` accepte toujours un nombre formaté selon la locale « C ».

L'exemple suivant montre un objet ` TextInput ` avec un `IntValidator` permettant de vérifier que l'utilisateur a saisi un entier compris dans la plage spécifiée, en modifiant la couleur du texte pour mettre en évidence les saisies non valides :

import QtQuick

TextInput {
    focus: true
    validator: IntValidator {
        bottom: 0
        top: 100
    }
    color: acceptableInput ? "black" : "red";
}

Le validateur empêchera la soumission de texte qui ne peut en aucun cas être valide. Cependant, lors de la saisie, seules les invalidités facilement identifiables seront bloquées, par exemple les conflits de signe ou un nombre trop élevé de chiffres non nuls. Cela peut parfois surprendre. Le validateur de l’exemple ci-dessus autorisera par exemple la saisie de « 999 », car les valeurs composées d’un nombre de chiffres égal ou inférieur à la valeur maximale sont considérées comme « intermédiaires » – ce qui signifie qu’elles se trouvent dans un état où elles ne sont pas valides, mais pourraient être ajustées pour le devenir. C’est voulu, car le chiffre qui empêche un nombre d’être dans la plage n’est pas nécessairement le dernier chiffre saisi. Cela signifie également qu’un nombre intermédiaire peut comporter des zéros en tête.

L’ajout d’un indicateur visuel basé sur la propriété ` acceptableInput ` d’ TextInput permet d’indiquer clairement à l’utilisateur si ce qu’il a saisi sera effectivement accepté.

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

Documentation sur les propriétés

bottom : int

Cette propriété contient la valeur minimale acceptable du validateur. Par défaut, la valeur de cette propriété est dérivée de l'entier signé le plus petit disponible (généralement -2147483647).

locale : string

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

Voir également la fonction ` Qt.locale()`.

top : int

Cette propriété contient la valeur maximale acceptable pour le validateur. Par défaut, la valeur de cette propriété est dérivée du plus grand entier signé disponible (généralement 2147483647).