QSpinBox Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine Spinbox mit 0 als Minimalwert und 99 als Maximalwert, einem Schrittwert von 1. Der Wert ist anfangs auf 0 gesetzt. Sie ist parent untergeordnet.

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

[virtual noexcept] QSpinBox::~QSpinBox()

Zerstörer.

[override virtual protected] bool QSpinBox::event(QEvent *event)

Reimplements: QAbstractSpinBox::event(QEvent *Event).

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

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

void QSpinBox::setRange(int minimum, int maximum)

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

setRange(minimum, maximum);

ist äquivalent zu:

setMinimum(minimum);
setMaximum(maximum);

Siehe auch minimum und maximum.

void QSpinBox::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 geht die Schrittweite von -1100 auf -1200 zurück.

Die Schrittrichtung wird bei der Behandlung von Flankenfällen berücksichtigt, so dass ein Schritt von 100 nach unten den Wert auf 99 statt auf 90 erhöht. 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 QSpinBox::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 protected] QString QSpinBox::textFromValue(int 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 auf die übliche Weise mit QWidget::locale().toString() gedruckt wird, wobei jedoch das Tausendertrennzeichen entfernt wird, es sei denn, setGroupSeparatorShown() ist gesetzt. Reimplementierungen können alles zurückgeben. (Siehe das Beispiel in der ausführlichen Beschreibung.)

Hinweis: QSpinBox 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() und validate() neu implementieren.

Siehe auch valueFromText(), validate(), und QLocale::groupSeparator().

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

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

[signal] void QSpinBox::valueChanged(int i)

Dieses Signal wird immer dann ausgegeben, wenn der Wert der Spin-Box geändert wird. Der Integer-Wert des neuen Wertes wird in i übergeben.

[virtual protected] int QSpinBox::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: QSpinBox behandelt specialValueText() separat; diese Funktion befasst sich nur mit den anderen Werten.

Siehe auch textFromValue() und validate().