IntValidator QML Type

Definiert einen Validator für Ganzzahlwerte. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

Der Typ „IntValidator“ stellt einen Validator für ganzzahlige Werte bereit.

Wenn kein „ locale “ festgelegt ist, verwendet „IntValidator“ die „ default locale “, um die Zahl zu interpretieren, und akzeptiert lokalespezifische Ziffern, Gruppentrennzeichen sowie Vorzeichen („+“ und „-“). Darüber hinaus akzeptiert „IntValidator“ garantiert immer eine Zahl, die gemäß der Locale „C“ formatiert ist.

Das folgende Beispiel zeigt ein „ TextInput “-Objekt mit einem „IntValidator“, der überprüft, ob der Benutzer eine ganze Zahl innerhalb des angegebenen Bereichs eingegeben hat, und 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 das Absenden von Text, der unmöglich gültig sein kann. Während der Bearbeitung werden jedoch nur leicht erkennbare Ungültigkeiten blockiert, zum Beispiel Vorzeichenkonflikte oder zu viele Ziffern ungleich Null. Dies kann manchmal überraschend sein. Der Validator im obigen Beispiel lässt beispielsweise die Eingabe von „999“ zu, da Werte, deren Ziffernanzahl dem Maximalwert entspricht oder darunter liegt, als „Zwischenwerte“ betrachtet werden – das heißt, sie befinden sich in einem Zustand, in dem sie zwar noch nicht gültig sind, aber so angepasst werden könnten, dass sie gültig werden. Dies ist beabsichtigt, da die Ziffer, die verhindert, dass eine Zahl im zulässigen Bereich liegt, nicht unbedingt die zuletzt eingegebene Ziffer ist. Das bedeutet auch, dass eine „Zwischenzahl“ führende Nullen enthalten kann.

Das Hinzufügen einer visuellen Anzeige auf Basis der Eigenschaft „ acceptableInput “ von TextInput kann dem Benutzer verdeutlichen, ob seine Eingabe tatsächlich akzeptiert wird.

Siehe auch „ DoubleValidator “, „ RegularExpressionValidator “ und „Validierung von Eingabetext“.

Dokumentation zur Eigenschaft

bottom : int

Diese Eigenschaft enthält den niedrigsten zulässigen Wert des Validators. Standardmäßig wird der Wert dieser Eigenschaft aus der niedrigsten verfügbaren vorzeichenbehafteten Ganzzahl abgeleitet (in der Regel -2147483647).

locale : string

Diese Eigenschaft enthält den Namen der Ländereinstellung, die zur Interpretation der Zahl verwendet wird.

Siehe auch ` Qt.locale()`.

top : int

Diese Eigenschaft enthält den höchsten zulässigen Wert des Validators. Standardmäßig wird der Wert dieser Eigenschaft aus der höchsten verfügbaren vorzeichenbehafteten Ganzzahl abgeleitet (in der Regel 2147483647).