Verwenden des VCL-Steuerelements TNumberBox

Nach oben zu VCL

Das VCL-Steuerelement TNumberBox ist ein modern gestaltetes Steuerelement für numerische Eingaben, das dem WinUI-Steuerelement NumberBox der Windows-Plattform nachgebildet ist. Das Steuerelement unterstützt die Eingabe von Ganzzahlen, Gleitkommazahlen mit festen Dezimalstellen und entsprechender Formatierung und Währungswerten.

Benutzer können den Wert mithilfe der Pfeiltasten oder der zulässigen Tasten oder des Mausrads erhöhen oder verringern und mit Hilfe der Bild-auf- und Bild-ab-Tasten auch um einen größeren Wert erhöhen oder verringern.

Die Komponente unterstützt die Auswertung einfacher Ausdrücken. Wenn dies aktiviert ist, können Benutzer einen Ausdruck wie 40 + 2 eingeben, und das Steuerelement ersetzt diesen durch das Ergebnis.

Das Steuerelement unterstützt Inline-Berechnungen grundlegender Gleichungen wie Multiplikation, Division, Addition und Subtraktion (und erlaubt die Verwendung von Klammern). Beachten Sie, dass Sie die Symbole + und – sowohl als binäre als auch als unäre Operationen verwenden können. Sie können also –23 oder + 23 eingeben, Sie können 55+23 und 55–23 schreiben und sie sogar kombinieren wie in 53++23 oder 53– –23, was zu 53 – (–23) ausgewertet wird, also die beiden Werte addiert werden.

Die Komponente enthält ein optionales Drehfeld, das mit der Eigenschaft SpinButtonOptions Placement konfiguriert wird und das kompakt, inline oder deaktiviert sein kann, wie unten gezeigt ist:

Liste der Eigenschaften der Komponente TNumberBox

Das Steuerelement unterstützt VCL-Stile, ist High-DPI-fähig und bietet viele weitere Eigenschaften, um den visuellen Stil und das Verhalten anzupassen. Hier ist eine Liste der Eigenschaften des Steuerelements:

Mode: TNumberBoxMode	Definiert, in welchem Modus das Steuerelement arbeitet und basiert auf der folgenden Aufzählung: TNumberBoxMode = (nbmInteger, nbmFloat, nbmCurrency);
Value: Extended	Aktueller Wert
ValueInt: Integer	Aktueller Wert als Ganzzahl
ValueFloat: Extended	Aktueller Wert als erweitert gerundet anhand der Eigenschaft Decimal
ValueCurrency: Extended	Aktueller Wert als erweitert gerundet mit Decimal = 2
CurrencyString: String	Definiert den String für den Währungsmodus, der am Ende des Anzeigetexts hinzugefügt wird
DisplayFormat: String	Definiert das benutzerdefinierte Textformat
MinValue: Extended	Definiert den Mindestwert
MaxValue: Extended	Definiert den Maximalwert
Decimal: Byte	Definiert die Anzahl der Dezimalstellen
SmallStep: Extended	Definiert den Bereich, um den sich die Eigenschaft Value bei Betätigung des Drehfelds, der Auf-/Ab-Tasten und des Mausrads ändert.
LargeStep: Extended	Definiert den Bereich, um den sich die Eigenschaft Value beim Betätigen der Bild-auf-/Bild-ab-Tasten ändert
AcceptExpressions: Boolean	Aktiviert die Verwendung von Ausdrücken in dem Steuerelement
SpinButtonOptions: TNumberBoxSpinButtonOptions	Definiert die Optionen des Drehfelds und ist eine Datenstruktur mit den Untereigenschaften ButtonWidth, Placement, RepeatTimerInterval, ShowInlineDividers und verschiedenen Pfeilfarben
UseNaNValue: Boolean	Verwendet den NaN-Wert mit leerem Text
UseMouseWheel: Boolean	Aktiviert das Ändern von Value mit dem Mausrad anhand der Eigenschaft SmallStep
UseUpDownKeys: Boolean	Aktiviert das Ändern von Value mit den Tasten Auf/Ab und Bild auf/Bild ab
Wrap: Boolean	Aktiviert das Inkrementieren vom Maximalwert zum Mindestwert und umgekehrt

Liste der Ereignisse der Komponente TNumberBox

Die Komponente hat die folgenden Ereignisse:

OnChangeValue: TNotifyEvent	Tritt auf, wenn die Eigenschaft Value geändert wird
OnEvaluateExpression: TNotifyEvent	Tritt auf, wenn die benutzerdefinierte Auswertung eines Ausdrucks mit den Eigenschaften Text und Value angewendet wird
OnValidateChar: TNumberBoxValidateCharEvent	Benutzerdefinierte Validierung der Eingabezeichen