Auf dieser Seite

DoubleValidator QML Type

Definiert einen Validator für nicht-ganzzahlige Zahlen. Mehr...

Import Statement: import QtQuick
In C++: QDoubleValidator

Eigenschaften

Ausführliche Beschreibung

Der Typ „DoubleValidator“ stellt einen Validator für nicht-ganzzahlige Zahlen bereit.

  • Akzeptierte Eingabe: Die Eingabe wird akzeptiert, wenn sie einen Double-Wert enthält, der innerhalb des gültigen Bereichs liegt und das richtige Format aufweist.
  • Akzeptierte, aber ungültige Eingabe: Die Eingabe wird akzeptiert, gilt jedoch als ungültig, wenn sie einen Double-Wert enthält, der außerhalb des gültigen Bereichs liegt oder das falsche Format hat (z. B. zu viele Stellen nach dem Komma oder leer).
  • Abgelehnte Eingabe: Die Eingabe wird abgelehnt, wenn es sich nicht um einen „double“-Wert handelt.

Hinweis: Wenn der gültige Bereich nur aus positiven Double-Werten besteht (z. B. 0,0 bis 100,0) und die Eingabe ein negativer Double-Wert ist, wird sie abgelehnt. Wenn „ notation “ auf „ DoubleValidator.StandardNotation “ gesetzt ist und die Eingabe mehr Ziffern vor dem Komma enthält, als ein Double-Wert im gültigen Bereich haben darf, wird sie ebenfalls abgelehnt. Wenn „ notation “ auf „ DoubleValidator.ScientificNotation “ gesetzt ist und die Eingabe nicht im gültigen Bereich liegt, wird sie zwar akzeptiert, ist aber ungültig. Der Wert kann durch Ändern des Exponenten gültig werden.

Das folgende Beispiel zeigt ein „ TextInput “-Objekt mit einem „DoubleValidator“, der überprüft, ob der Benutzer einen „double“-Wert innerhalb des angegebenen Bereichs eingegeben hat, und die Textfarbe aktualisiert, um ungültige Eingaben hervorzuheben:

import QtQuick

TextInput {
    focus: true
    validator: DoubleValidator {
        bottom: 0.00
        top: 100.00
        decimals: 2
        notation: DoubleValidator.StandardNotation
    }
    onAcceptableInputChanged:
        color = acceptableInput ? "black" : "red";
}

Siehe auch „ IntValidator “, „ RegularExpressionValidator “ und „Validating Input Text“.

Dokumentation zu den Eigenschaften

bottom : real

Diese Eigenschaft enthält den vom Validator akzeptierten Mindestwert. Standardmäßig enthält diese Eigenschaft den Wert -unendlich.

decimals : int

Diese Eigenschaft gibt die maximale Anzahl von Stellen nach dem Komma für den Validator an. Standardmäßig ist diese Eigenschaft auf den Wert 1000 gesetzt.

locale : string

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

Siehe auch ` Qt.locale()`.

notation : enumeration

Diese Eigenschaft enthält die Angabe, wie eine Zeichenfolge eine Zahl beschreiben kann.

Die möglichen Werte für diese Eigenschaft sind:

KonstanteBeschreibung
DoubleValidator.StandardNotationnur Dezimalzahlen mit optionalem Vorzeichen (z. B. -0.015)
DoubleValidator.ScientificNotation(Standard) Die geschriebene Zahl darf einen Exponentialteil enthalten (z. B. 1.5E-2)

top : real

Diese Eigenschaft enthält den maximal zulässigen Wert des Validators. Standardmäßig ist diese Eigenschaft auf unendlich gesetzt.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.