QDoubleValidator Class

Dokumentation zu den Member-Funktionen

[explicit] QDoubleValidator::QDoubleValidator(QObject *parent = nullptr)

Erstellt ein Validator-Objekt mit einem „ parent “-Objekt, das beliebige Double-Werte akzeptiert.

QDoubleValidator::QDoubleValidator(double bottom, double top, int decimals, QObject *parent = nullptr)

Erstellt ein Validator-Objekt mit einem „ parent “-Objekt. Dieser Validator akzeptiert Double-Werte im Bereich von bottom bis einschließlich top mit bis zu decimals Stellen nach dem Komma.

[virtual noexcept] QDoubleValidator::~QDoubleValidator()

Löscht den Validator.

[override virtual, since 6.3] void QDoubleValidator::fixup(QString &input) const

Implementiert: ` QValidator::fixup(QString &input) const`.

Versucht, die Zeichenkette „ input “ in eine „ Acceptable “-Darstellung eines „double“-Werts umzuwandeln.

Das Format der Zahl wird durch notation(), decimals(), locale() und dessen numberOptions() bestimmt.

Um notation() zu erfüllen, wird bei Verwendung von ScientificNotation der feste Wert in seiner normalisierten Form dargestellt, was bedeutet, dass jeder Wert ungleich Null eine Ziffer ungleich Null vor dem Dezimalpunkt aufweist.

QString input = "0.98765e2";
QDoubleValidator val;
val.setLocale(QLocale::C);
val.setNotation(QDoubleValidator::ScientificNotation);
val.fixup(input); // input == "9.8765e+01"

Um den Anforderungen von ` decimals()` zu entsprechen, wird bei Verwendung von ` -1 ` die Anzahl der verwendeten Ziffern durch ` QLocale::FloatingPointShortest` bestimmt. Andernfalls wird der Bruchteil der Zahl (ggf. mit Rundung) abgeschnitten, wenn seine Länge ` decimals()` überschreitet. Wenn ` notation()` auf ` ScientificNotation ` gesetzt ist, erfolgt dies, nachdem die Zahl in ihre normalisierte Form gebracht wurde.

input = "-1234.6789";
val.setDecimals(2);
val.setLocale(QLocale::C);
val.setNotation(QDoubleValidator::StandardNotation);
val.fixup(input); // input == "-1234.68"

Diese Funktion wurde in Qt 6.3 eingeführt.

void QDoubleValidator::setRange(double minimum, double maximum, int decimals)

Legt fest, dass der Validator Double-Werte im Bereich von minimum bis einschließlich maximum akzeptiert, mit maximal decimals Stellen nach dem Komma.

void QDoubleValidator::setRange(double minimum, double maximum)

Stellt den Validator so ein, dass er Double-Werte im Bereich von minimum bis einschließlich maximum akzeptiert, ohne die Anzahl der Stellen hinter dem Komma zu ändern.

[override virtual] QValidator::State QDoubleValidator::validate(QString &input, int &pos) const

Implementiert: ` QValidator::validate(QString &input, int &pos) const`.

Gibt ` Acceptable ` zurück, wenn die Zeichenkette ` input ` das richtige Format aufweist und einen `double`-Wert innerhalb des gültigen Bereichs enthält.

Gibt ` Intermediate ` zurück, wenn ` input ` das falsche Format hat oder einen `double`-Wert außerhalb des zulässigen Bereichs enthält.

Gibt „ Invalid “ zurück, wenn „ input “ keinen Double-Wert darstellt oder zu viele Stellen nach dem Komma enthält.

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

Standardmäßig wird der Parameter „ pos “ von diesem Validator nicht verwendet.