QDoubleSpinBox Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert einen Drehkasten mit 0,0 als Minimalwert und 99,99 als Maximalwert, einem Schrittwert von 1,0 und einer Genauigkeit von 2 Dezimalstellen. Der Wert wird zunächst auf 0,00 gesetzt. Die Spinbox hat die angegebene parent.

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

[virtual noexcept] QDoubleSpinBox::~QDoubleSpinBox()

Zerstörer.

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

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

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

Convenience-Funktion zum Festlegen der Werte minimum und maximum mit einem einzigen Funktionsaufruf.

Hinweis: Die Maximal- und Minimalwerte werden gerundet, um der Dezimaleigenschaft zu entsprechen.

setRange(minimum, maximum);

ist äquivalent zu:

setMinimum(minimum);
setMaximum(maximum);

Siehe auch minimum und maximum.

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

Stellt den Schritttyp für den Drehkasten auf stepType ein, d. h. Einzelschritt oder adaptiver Dezimalschritt.

Adaptiver Dezimalschritt bedeutet, dass die Schrittweite kontinuierlich um eine Zehnerpotenz unter dem aktuellen value angepasst wird. Wenn der Wert also 1100 beträgt, ist die Schrittweite auf 100 eingestellt, so dass eine einmalige Erhöhung den Wert auf 1200 erhöht. Bei einem Wert von 1200 erhöht sich die Schrittweite auf 1300. Bei negativen Werten führt ein Schritt nach unten von -1100 zu -1200.

Es funktioniert auch für beliebige Dezimalwerte, 0,041 wird durch einmaliges Steppen auf 0,042 erhöht.

Die Schrittrichtung wird berücksichtigt, um Kantenfälle zu behandeln, so dass ein Schritt von 100 nach unten den Wert auf 99 statt auf 90 bringt. Ein Schritt nach oben gefolgt von einem Schritt nach unten - oder umgekehrt - landet also immer auf dem Ausgangswert; 99 -> 100 -> 99.

Wird diese Eigenschaft gesetzt, ignoriert die Spin-Box den Wert von singleStep, obwohl er erhalten bleibt, so dass singleStep wirksam wird, wenn der adaptive Dezimalschritt später deaktiviert wird.

Siehe auch stepType().

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

Dieses Signal wird immer dann ausgegeben, wenn der Text der Spinbox geändert wird. Der neue Text wird in text mit prefix() und suffix() übergeben.

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

Diese virtuelle Funktion wird von der Spin-Box immer dann verwendet, wenn sie die angegebene value anzeigen muss. Die Standardimplementierung gibt eine Zeichenkette zurück, die value enthält und mit QWidget::locale() gedruckt wird.toString(value, u'f', decimals()) und entfernt das Tausendertrennzeichen, sofern nicht setGroupSeparatorShown() gesetzt ist. Reimplementierungen können alles 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 dies 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

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

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

Dieses Signal wird immer dann ausgegeben, wenn der Wert der Spin-Box geändert wird. Der neue Wert wird in d übergeben.

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

Diese virtuelle Funktion wird vom Drehkasten immer dann verwendet, wenn er die vom Benutzer eingegebene Adresse text als Wert interpretieren muss.

Unterklassen, die Spin-Box-Werte auf eine 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().