IntValidator QML Type

Définit un validateur pour les valeurs entières. Plus d'informations...

• 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 locale n'est défini, IntValidator utilise default locale pour interpréter le nombre et acceptera les chiffres spécifiques à la locale, les séparateurs de groupe et les signes positifs et négatifs. En outre, IntValidator est toujours assuré d'accepter un nombre formaté selon la locale "C".

L'exemple suivant montre un objet TextInput avec un IntValidator pour vérifier que l'utilisateur a saisi un nombre entier dans la plage spécifiée, en mettant à jour la couleur du texte pour mettre en évidence les entrées non valides :

import QtQuick

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

Le validateur empêchera la soumission d'un texte qui ne peut pas être valide. Cependant, lors de l'édition, seule une invalidité facilement identifiable sera bloquée, par exemple des conflits de signes ou un trop grand nombre de chiffres non nuls. Cela peut parfois être surprenant. Dans l'exemple ci-dessus, le validateur 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", c'est-à-dire qu'elles se trouvent dans un état où elles ne sont pas valides, mais où elles pourraient être ajustées pour l'être. Cela s'explique par le fait que le chiffre qui empêche un nombre d'être dans l'intervalle n'est pas nécessairement le dernier chiffre tapé. Cela signifie également qu'un nombre intermédiaire peut comporter des zéros initiaux.

L'ajout d'un indicateur visuel basé sur la propriété acceptableInput de TextInput peut indiquer clairement à l'utilisateur si ce qu'il a tapé sera effectivement accepté.

Voir également DoubleValidator, RegularExpressionValidator, et Validation du texte d'entrée.

Documentation sur les propriétés

bottom : int

Cette propriété contient la plus petite valeur acceptable du validateur. Par défaut, la valeur de cette propriété est dérivée de l'entier signé le plus bas disponible (typiquement -2147483647).

locale : string

Cette propriété contient le nom de la locale utilisée pour interpréter le nombre.

Voir aussi Qt.locale().

top : int

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