QDoubleSpinBox Class

Dokumentation der Mitgliedsfunktionen

[explicit] QDoubleSpinBox::QDoubleSpinBox(QWidget *parent = nullptr)

Erstellt ein Spin-Feld mit dem Mindestwert 0,0 und dem Höchstwert 99,99, einem Schrittwert von 1,0 und einer Genauigkeit von 2 Dezimalstellen. Der Wert ist anfänglich auf 0,00 gesetzt. Das Spin-Feld hat die angegebene URL parent.

Siehe auch setMinimum(), setMaximum() und setSingleStep().

[virtual noexcept] QDoubleSpinBox::~QDoubleSpinBox()

Destruktor.

[override virtual] void QDoubleSpinBox::fixup(QString &input) const

Implementiert neu: ` QAbstractSpinBox::fixup(QString &input) const`.

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

Praktische Funktion zum Festlegen der Werte für „ minimum “ und „ maximum “ mit einem einzigen Funktionsaufruf.

Hinweis: Die Maximal- und Minimalwerte werden entsprechend der Eigenschaft „decimals“ gerundet.

setRange(minimum, maximum);

entspricht:

setMinimum(minimum);
setMaximum(maximum);

Siehe auch „ minimum “ und „ maximum “.

void QDoubleSpinBox::setStepType(QAbstractSpinBox::StepType stepType)

Legt den Schritt-Typ für das Eingabefeld auf „ stepType “ fest, d. h. „Einzelschritt“ oder „adaptiver Dezimalschritt“.

„Adaptiver Dezimalschritt“ bedeutet, dass die Schrittweite kontinuierlich auf eine Zehnerpotenz unterhalb des aktuellen Werts „ value “ angepasst wird. Wenn der Wert also 1100 beträgt, wird der Schritt auf 100 gesetzt, sodass eine Erhöhung um einen Schritt den Wert auf 1200 erhöht. Bei einem Wert von 1200 führt eine Erhöhung um einen Schritt zu 1300. Bei negativen Werten führt ein Schritt nach unten von -1100 zu -1200.

Dies gilt auch für beliebige Dezimalwerte: 0,041 wird durch einen Schritt auf 0,042 erhöht.

Die Schritt-Richtung wird berücksichtigt, um Randfälle zu behandeln, sodass ein Schritt nach unten von 100 den Wert auf 99 statt auf 90 setzt. Somit landet ein Schritt nach oben, gefolgt von einem Schritt nach unten – oder umgekehrt – immer wieder beim Ausgangswert; 99 -> 100 -> 99.

Wird diese Option aktiviert, ignoriert das Eingabefeld den Wert von „ singleStep “, obwohl dieser beibehalten wird, sodass „ singleStep “ wirksam wird, falls die adaptive Dezimalschrittweite später deaktiviert wird.

Siehe auch stepType().

[signal] void QDoubleSpinBox::textChanged(const QString &text)

Dieses Signal wird immer dann ausgelöst, wenn der Text des Spin-Feldes geändert wird. Der neue Text wird über die Methoden ` prefix()` und ` suffix()` an ` text ` übergeben.

[virtual] QString QDoubleSpinBox::textFromValue(double value) const

Diese virtuelle Funktion wird vom Spin-Feld verwendet, wann immer es das angegebene „ value “ anzeigen muss. Die Standardimplementierung gibt eine Zeichenkette zurück, die „ value “ enthält, ausgedruckt mit „ QWidget::locale()“. „toString “ (value, u'f', decimals()) entfernt das Tausendertrennzeichen, sofern „ setGroupSeparatorShown()“ nicht gesetzt ist. Eigenimplementierungen können beliebige Werte zurückgeben.

Hinweis: ` QDoubleSpinBox ` ruft diese Funktion nicht für ` specialValueText()` auf, und weder ` prefix()` noch ` suffix()` sollten im Rückgabewert enthalten sein.

Wenn Sie diese Funktion neu implementieren, müssen Sie möglicherweise auch valueFromText() neu implementieren.

Siehe auch „ valueFromText()“ und „ QLocale::groupSeparator()“.

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

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

[signal] void QDoubleSpinBox::valueChanged(double d)

Dieses Signal wird immer dann ausgelöst, wenn der Wert des Spin-Feldes geändert wird. Der neue Wert wird in „ d “ übergeben.

[virtual] double QDoubleSpinBox::valueFromText(const QString &text) const

Diese virtuelle Funktion wird von der Spin-Box immer dann verwendet, wenn sie vom Benutzer eingegebene „ text “ als Wert interpretieren muss.

Unterklassen, die Werte aus Spin-Boxen auf nicht-numerische Weise anzeigen müssen, müssen diese Funktion neu implementieren.

Hinweis: ` QDoubleSpinBox ` behandelt ` specialValueText()` separat; diese Funktion befasst sich nur mit den anderen Werten.

Siehe auch ` textFromValue()` und ` validate()`.