SpinBox QML Type

Diese Eigenschaft enthält den textuellen Wert der SpinBox.

Der Wert der Eigenschaft basiert auf textFromValue und locale, und ist gleich:

var text = spinBox.textFromValue(spinBox.value, spinBox.locale)

Diese Eigenschaft wurde in QtQuick.Controls 2.4 (Qt 5.11) eingeführt.

Siehe auch textFromValue.

Diese Eigenschaften enthalten das Element des Abwärtsindikators und geben an, ob es gedrückt ist oder mit dem Mauszeiger bewegt wird. Die Eigenschaft down.hovered wurde in QtQuick.Controls 2.1 eingeführt, und die Eigenschaften down.implicitIndicatorWidth und down.implicitIndicatorHeight wurden in QtQuick.Controls 2.5 eingeführt.

Siehe auch decrease().

Diese Eigenschaft gibt an, ob die Spinbox editierbar ist. Der Standardwert ist false.

Siehe auch validator.

Diese Eigenschaft enthält den Startwert für den Bereich. Der Standardwert ist 0.

Siehe auch to und value.

Diese Eigenschaft gibt an, ob ein editierbares Drehfeld eine partielle Texteingabe durch eine Eingabemethode hat.

Während des Zusammensetzens kann eine Eingabemethode auf Maus- oder Tastenereignisse des Drehkastens angewiesen sein, um den Teiltext zu bearbeiten oder zu bestätigen. Diese Eigenschaft kann verwendet werden, um zu bestimmen, wann Event-Handler, die den korrekten Betrieb einer Eingabemethode stören könnten, deaktiviert werden sollen.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Diese Eigenschaft gibt der Eingabemethode Hinweise über den erwarteten Inhalt der Spinbox und wie sie funktionieren soll.

Der Standardwert ist Qt.ImhDigitsOnly.

Der Wert ist eine bitweise Kombination von Flags oder Qt.ImhNone, wenn keine Hinweise gesetzt sind.

Flags, die das Verhalten verändern, sind:

• Qt.ImhHiddenText - Zeichen sollten versteckt werden, wie es typischerweise bei der Eingabe von Passwörtern verwendet wird.
• Qt.ImhSensitiveData - Eingegebener Text sollte von der aktiven Eingabemethode nicht in einem persistenten Speicher wie dem prädiktiven Benutzerwörterbuch gespeichert werden.
• Qt.ImhNoAutoUppercase - Die Eingabemethode sollte nicht versuchen, am Ende eines Satzes automatisch auf Großbuchstaben umzuschalten.
• Qt.ImhPreferNumbers - Zahlen werden bevorzugt (sind aber nicht erforderlich).
• Qt.ImhPreferUppercase - Großbuchstaben werden bevorzugt (sind aber nicht erforderlich).
• Qt.ImhPreferLowercase - Kleinbuchstaben werden bevorzugt (sind aber nicht erforderlich).
• Qt.ImhNoPredictiveText - Keine Textvorhersage (d.h. Wörterbuchsuche) während des Tippens verwenden.
• Qt.ImhDate - Der Texteditor funktioniert wie ein Datumsfeld.
• Qt.ImhTime - Der Texteditor funktioniert wie ein Zeitfeld.

Flags, die die Eingabe einschränken (exklusive Flags) sind:

• Qt.ImhDigitsOnly - Nur Ziffern sind erlaubt.
• Qt.ImhFormattedNumbersOnly - Nur die Eingabe von Zahlen ist erlaubt. Dies schließt Dezimalpunkt und Minuszeichen ein.
• Qt.ImhUppercaseOnly - Nur die Eingabe von Großbuchstaben ist erlaubt.
• Qt.ImhLowercaseOnly - Nur die Eingabe von Kleinbuchstaben ist erlaubt.
• Qt.ImhDialableCharactersOnly - Nur Zeichen, die für die Telefonwahl geeignet sind, sind erlaubt.
• Qt.ImhEmailCharactersOnly - Nur Zeichen, die für E-Mail-Adressen geeignet sind, sind erlaubt.
• Qt.ImhUrlCharactersOnly - Nur Zeichen, die für URLs geeignet sind, sind erlaubt.

Masken:

• Qt.ImhExclusiveInputMask - Diese Maske ergibt einen Wert ungleich Null, wenn eines der Exklusiv-Flags verwendet wird.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Diese Eigenschaft legt fest, ob value aktualisiert wird, wenn der Benutzer displayText editiert. Der Standardwert ist false. Wenn diese Eigenschaft true ist und der vom Benutzer eingegebene Wert gültig ist und innerhalb der Grenzen der Spinbox [from, to] liegt, wird der Wert von SpinBox gesetzt. Wenn diese Eigenschaft false ist oder der vom Benutzer eingegebene Wert außerhalb der Grenzen liegt, wird der Wert nicht aktualisiert, bis die Enter- oder Return-Taste gedrückt wird oder das Eingabefeld den Fokus verliert.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch editable und displayText.

Diese Eigenschaft gibt die Schrittweite an. Der Standardwert ist 1.

Siehe auch increase() und decrease().

Diese Eigenschaft enthält eine Callback-Funktion, die immer dann aufgerufen wird, wenn ein Integer-Wert in Anzeigetext umgewandelt werden muss.

Die Standardfunktion kann überschrieben werden, um benutzerdefinierten Text für einen bestimmten Wert anzuzeigen. Dies gilt sowohl für bearbeitbare als auch für nicht bearbeitbare Spinboxen; wenn beispielsweise die Auf- und Ab-Tasten oder ein Mausrad zum Erhöhen und Verringern des Wertes verwendet werden, wird der neue Wert mithilfe dieser Funktion in Anzeigetext umgewandelt.

Die Signatur der Callback-Funktion lautet string function(value, locale). Die Funktion kann ein oder zwei Argumente haben, wobei das erste Argument der zu konvertierende Wert und das optionale zweite Argument das Gebietsschema ist, das für die Konvertierung verwendet werden soll, falls zutreffend.

Die Standardimplementierung führt die Konvertierung mit Number.toLocaleString() durch:

textFromValue: function(value, locale) { return Number(value).toLocaleString(locale, 'f', 0); }

Siehe auch valueFromText, validator, und locale.

Diese Eigenschaft enthält den Endwert für den Bereich. Der Standardwert ist 99.

Siehe auch from und value.

Diese Eigenschaften enthalten das Element des Aufwärtsindikators und geben an, ob es gedrückt oder mit dem Mauszeiger bewegt wird. Die Eigenschaft up.hovered wurde in QtQuick.Controls 2.1 eingeführt, und die Eigenschaften up.implicitIndicatorWidth und up.implicitIndicatorHeight wurden in QtQuick.Controls 2.5 eingeführt.

Siehe auch increase().

Diese Eigenschaft enthält den Eingabetext-Validator für editierbare Spinboxen. Standardmäßig verwendet SpinBox IntValidator , um die Eingabe ganzer Zahlen zu akzeptieren.

SpinBox {
    id: control
    validator: IntValidator {
        locale: control.locale.name
        bottom: Math.min(control.from, control.to)
        top: Math.max(control.from, control.to)
    }
}

Siehe auch editable, textFromValue, valueFromText, locale, und Validierung von Eingabetext.

Diese Eigenschaft enthält den Wert im Bereich from - to. Der Standardwert ist 0.

Diese Eigenschaft enthält eine Callback-Funktion, die immer dann aufgerufen wird, wenn der Eingabetext in einen Integer-Wert umgewandelt werden muss.

Diese Funktion muss nur überschrieben werden, wenn textFromValue für eine editierbare Spinbox überschrieben wird.

Die Signatur der Callback-Funktion lautet int function(text, locale). Die Funktion kann ein oder zwei Argumente haben, wobei das erste Argument der zu konvertierende Text und das optionale zweite Argument das Gebietsschema ist, das für die Konvertierung verwendet werden soll, falls zutreffend.

Die Standardimplementierung führt die Konvertierung mit Number.fromLocaleString() durch:

valueFromText: function(text, locale) { return Number.fromLocaleString(locale, text); }

Siehe auch textFromValue, validator, und locale.

Diese Eigenschaft legt fest, ob die Spinbox umgebrochen wird. Der Standardwert ist false.

Wenn wrap true ist, ändert sich der Wert nach to zu from und umgekehrt.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Dieses Signal wird ausgegeben, wenn der Wert des Drehfelds vom Benutzer interaktiv geändert wurde, entweder durch Berührung, Maus, Rad oder Tasten. Im Falle der Interaktion über die Tastatur wird das Signal nur ausgegeben, wenn der Text akzeptiert wurde, d. h. wenn die Eingabe- oder Eingabetaste gedrückt wird oder das Eingabefeld den Fokus verliert.

Dieses Signal wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Verringert den Wert um stepSize, oder 1, wenn stepSize nicht definiert ist.

Siehe auch stepSize.

Erhöht den Wert um stepSize, bzw. 1, wenn stepSize nicht definiert ist.

Siehe auch stepSize.