QDoubleValidator Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein Validator-Objekt mit einem parent -Objekt, das ein beliebiges Double akzeptiert.

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

Konstruiert ein Validator-Objekt mit einem parent Objekt. Dieser Validator akzeptiert Doubles von bottom bis einschließlich top, mit bis zu decimals Nachkommastellen.

[virtual noexcept] QDoubleValidator::~QDoubleValidator()

Zerstört den Validator.

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

Reimplements: QValidator::fixup(QString &input) const.

Dies ist eine überladene Funktion.

Versucht, die Zeichenkette input auf eine Acceptable Darstellung eines Double zu fixieren.

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

Um notation() zu entsprechen, wird bei der Verwendung von ScientificNotation der feste Wert in seiner normalisierten Form dargestellt, was bedeutet, dass jeder Wert, der nicht Null ist, eine Stelle vor dem Dezimalpunkt hat, die nicht Null ist.

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

Um decimals() zu entsprechen, wird bei -1 die Anzahl der verwendeten Stellen durch QLocale::FloatingPointShortest bestimmt. Andernfalls wird der Nachkommateil der Zahl abgeschnitten (gegebenenfalls mit Rundung), wenn seine Länge decimals() überschreitet. Wenn notation() gleich ScientificNotation ist, geschieht 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)

Stellt den Validator so ein, dass er Doubles von minimum bis einschließlich maximum akzeptiert, mit maximal decimals Nachkommastellen.

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

Dies ist eine überladene Funktion.

Stellt den Validator so ein, dass er Doubles von minimum bis einschließlich maximum akzeptiert, ohne die Anzahl der Ziffern nach dem Dezimalpunkt zu ändern.

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

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

Gibt Acceptable zurück, wenn die Zeichenkette input das richtige Format hat und einen Double innerhalb des gültigen Bereichs enthält.

Gibt Intermediate zurück, wenn input im falschen Format ist oder einen Double außerhalb des Bereichs enthält.

Gibt Invalid zurück, wenn input keinen Pasch darstellt oder zu viele Nachkommastellen hat.

Hinweis: Wenn der gültige Bereich nur aus positiven Paschalen besteht (z. B. 0,0 bis 100,0) und input eine negative Paschale ist, wird Invalid zurückgegeben. Wenn notation() auf StandardNotation gesetzt ist und die Eingabe mehr Stellen vor dem Dezimalpunkt enthält, als ein Double 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 noch gültig werden, indem der Exponent geändert wird.

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