QValidator Class

Ausführliche Beschreibung

Die Klasse selbst ist abstrakt. Zwei Unterklassen, ` QIntValidator ` und ` QDoubleValidator`, bieten eine grundlegende Überprüfung des Zahlenbereichs, und ` QRegularExpressionValidator ` ermöglicht eine allgemeine Überprüfung mithilfe eines benutzerdefinierten regulären Ausdrucks.

Sollten die integrierten Validatoren nicht ausreichen, können Sie eine Unterklasse von `QValidator` erstellen. Die Klasse verfügt über zwei virtuelle Funktionen: ` validate()` und ` fixup()`.

validate() muss von jeder Unterklasse implementiert werden. Sie gibt je nachdem, ob ihr Argument gültig ist (gemäß der Definition der Unterklasse für „gültig“), Invalid, Intermediate oder Acceptable zurück.

Diese drei Zustände bedürfen einer Erläuterung. Eine Zeichenkette vom Typ „ Invalid “ ist eindeutig ungültig. „ Intermediate “ ist weniger offensichtlich: Das Konzept der Gültigkeit lässt sich nur schwer anwenden, wenn die Zeichenkette unvollständig ist (also noch bearbeitet wird). QValidator definiert „ Intermediate “ als die Eigenschaft einer Zeichenkette, die weder eindeutig ungültig ist noch als Endergebnis akzeptabel ist. „ Acceptable “ bedeutet, dass die Zeichenkette als Endergebnis akzeptabel ist. Man könnte sagen, dass jede Zeichenkette, die während der Eingabe einer „ Acceptable “-Zeichenkette einen plausiblen Zwischenzustand darstellt, „ Intermediate “ ist.

Hier sind einige Beispiele:

• Bei einem Eingabefeld, das ganze Zahlen von 10 bis einschließlich 1000 akzeptiert, sind 42 und 123 „ Acceptable “, die leere Zeichenkette, 5 oder 1234 sind „ Intermediate “, und „asdf“ sowie 10114 sind „ Invalid “.
• Bei einer bearbeitbaren Combobox, die URLs akzeptiert, ist jede wohlgeformte URL Acceptable, „http://example.com/“ ist Intermediate (möglicherweise wurde bei einer Kopier- und Einfügeaktion versehentlich ein Komma am Ende übernommen), die leere Zeichenfolge lautet Intermediate (der Benutzer hat möglicherweise den gesamten Text markiert und gelöscht, um eine neue URL einzugeben) und „http:///./“ lautet Invalid.
• Bei einem Drehfeld, das Längenangaben akzeptiert, sind „11 cm“ und „1 in“ Acceptable, „11“ und die leere Zeichenfolge sind Intermediate, und „http://example.com“ sowie „hour“ sind Invalid.

fixup() steht für Validatoren zur Verfügung, die bestimmte Benutzerfehler beheben können. Die Standardimplementierung führt keine Aktion aus. QLineEdit ruft beispielsweise fixup() auf, wenn der Benutzer die Eingabetaste (oder Return) drückt und der Inhalt derzeit nicht gültig ist. Dies gibt der Funktion fixup() die Möglichkeit, mit etwas „Zauberei“ eine Zeichenkette vom Typ Invalid in Acceptable umzuwandeln.

Ein Validator verfügt über eine Locale, die mit ` setLocale()` festgelegt wird. Diese wird in der Regel zum Parsen lokalisierter Daten verwendet. Beispielsweise nutzen ` QIntValidator ` und ` QDoubleValidator ` sie, um lokalisierte Darstellungen von Ganzzahlen und Gleitkommazahlen zu parsen.

QValidator wird in der Regel zusammen mit QLineEdit, QSpinBox und QComboBox verwendet.