QValidator Class

Detaillierte Beschreibung

Die Klasse selbst ist abstrakt. Zwei Unterklassen, QIntValidator und QDoubleValidator, bieten grundlegende Prüfungen für numerische Bereiche, und QRegularExpressionValidator bietet allgemeine Prüfungen unter Verwendung eines benutzerdefinierten regulären Ausdrucks.

Wenn die eingebauten Prüfer nicht ausreichen, können Sie QValidator als Unterklasse verwenden. Die Klasse hat zwei virtuelle Funktionen: validate() und fixup().

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

Diese drei Zustände bedürfen einiger Erklärung. Eine Zeichenkette Invalid ist eindeutig ungültig. Intermediate ist weniger offensichtlich: Das Konzept der Gültigkeit ist schwierig anzuwenden, wenn die Zeichenkette unvollständig ist (noch bearbeitet wird). QValidator definiert Intermediate als die Eigenschaft einer Zeichenfolge, die weder eindeutig ungültig noch als Endergebnis akzeptabel ist. Acceptable bedeutet, dass die Zeichenfolge als Endergebnis akzeptabel ist. Man könnte sagen, dass jede Zeichenkette, die einen plausiblen Zwischenzustand während der Eingabe einer Acceptable Zeichenkette darstellt, Intermediate ist.

Hier sind einige Beispiele:

• Für eine Eingabezeile, die ganze Zahlen von 10 bis einschließlich 1000 akzeptiert, sind 42 und 123 Acceptable, die leere Zeichenkette, 5 oder 1234 sind Intermediate, und "asdf" und 10114 ist Invalid.
• Bei einem bearbeitbaren Kombinationsfeld, das URLs akzeptiert, ist jede wohlgeformte URL Acceptable, "http://example.com/" ist Intermediate (es könnte sich um eine Ausschneide- und Einfügeaktion handeln, bei der versehentlich ein Komma am Ende eingefügt wurde), die leere Zeichenfolge ist Intermediate (der Benutzer könnte den gesamten Text auswählen und löschen, um eine neue URL einzugeben) und "http:///./" ist Invalid.
• Bei einem Drehfeld, das Längenangaben akzeptiert, sind "11cm" und "1in" Acceptable, "11" und die leere Zeichenkette sind Intermediate, und "http://example.com" und "hour" sind Invalid.

fixup() ist für Validatoren vorgesehen, die einige Benutzerfehler reparieren können. Die Standardimplementierung tut nichts. QLineEdit Die Funktion fixup() wird zum Beispiel aufgerufen, wenn der Benutzer die Eingabetaste (oder den Zeilenschalter) drückt und der Inhalt derzeit nicht gültig ist. Dies gibt der Funktion fixup() die Möglichkeit, eine Invalid Zeichenkette in Acceptable umzuwandeln.

Ein Validator hat ein Gebietsschema, das mit setLocale() festgelegt wird. Er wird normalerweise verwendet, um lokalisierte Daten zu parsen. Zum Beispiel verwenden QIntValidator und QDoubleValidator ihn, um lokalisierte Repräsentationen von Ganzzahlen und Doubles zu analysieren.

QValidator wird normalerweise mit QLineEdit, QSpinBox und QComboBox verwendet.