IntValidator QML Type

Definiert einen Validator für Integer-Werte. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Detaillierte Beschreibung

Der Typ IntValidator bietet einen Validator für Integer-Werte.

Wenn kein locale gesetzt ist, verwendet IntValidator die default locale, um die Zahl zu interpretieren und akzeptiert regionalspezifische Ziffern, Gruppentrennzeichen sowie positive und negative Vorzeichen. Darüber hinaus akzeptiert IntValidator garantiert immer eine Zahl, die gemäß dem Gebietsschema "C" formatiert ist.

Das folgende Beispiel zeigt ein TextInput Objekt mit einem IntValidator, der prüft, ob der Benutzer eine ganze Zahl innerhalb des angegebenen Bereichs eingegeben hat, und der die Textfarbe aktualisiert, um ungültige Eingaben hervorzuheben:

import QtQuick

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

Der Validator verhindert die Eingabe von Text, der unmöglich gültig sein kann. Während der Bearbeitung werden jedoch nur leicht erkennbare Ungültigkeiten blockiert, z. B. Vorzeichenkonflikte oder zu viele Nicht-Null-Ziffern. Dies kann manchmal überraschend sein. Der Validator im obigen Beispiel lässt z. B. die Eingabe von "999" zu, da Werte, die aus einer Anzahl von Ziffern bestehen, die gleich oder kleiner als der Maximalwert ist, als "Zwischenwert" betrachtet werden - was bedeutet, dass sie sich in einem Zustand befinden, in dem sie nicht gültig sind, aber so angepasst werden könnten, dass sie es sind. Dies ist beabsichtigt, weil die Ziffer, die verhindert, dass eine Zahl im Bereich liegt, nicht unbedingt die letzte eingegebene Ziffer ist. Das bedeutet auch, dass eine Zwischenzahl führende Nullen haben kann.

Durch Hinzufügen eines visuellen Indikators, der auf der Eigenschaft TextInput' acceptableInput basiert, kann dem Benutzer klar gemacht werden, ob das, was er eingegeben hat, tatsächlich akzeptiert wird.

Siehe auch DoubleValidator, RegularExpressionValidator, und Validierung von Eingabetext.

Eigenschaft Dokumentation