Step Input

GET_STEP_INPUT

Mit der Methode GET_STEP_INPUT bekommt man über die ControlID die Instanz des Step-Inputs zurück und hat dann Zugriff auf die Eigenschaften des Step-Inputs.

Ein Step ist ein Eingabefeld, das es Benutzern ermöglicht, numerische Werte schrittweise zu erhöhen oder zu verringern. Es kombiniert ein Textfeld mit zwei Buttons, mit denen der Wert um eine vordefinierte Schrittgröße angepasst werden kann. Es eignet sich besonders für Zahlenwerte, bei denen eine präzise und schrittweise Eingabe erforderlich ist, wie z. B. Mengenangaben oder Alter.

Attribute im Designer

Attribut	Beschreibung	Standardwert
controlId	Eindeutige Id der Komponente	Wird automatisch generiert
width	Breite des gesamten Controls. Im Gegensatz zur fieldWidth verändert sich hier die gesamte Breite, mit Label	100%
fieldWidth	Breite des Inputs, ohne die Breite des Controls zu beeinflussen. Die Breite des Labels verändert sich nicht
value	Wert, der in das Input eingegeben wurde
displayValuePrecision	Definiert die Anzahl der Nachkommastellen. Zugelassene Werte von 0 - 20	0
placeholder	Text, der bei leerem Wert angezeigt wird
description	Beschreibung des Controls, die im Label neben des Inputs angezeigt wird
min	Minimaler Value-Wert
max	Maximaler Value-Wert
step	Definiert die Schritte, um die sich der Value verändern soll, wenn der Plus- oder Minusbutton geklickt wird	true
stepMode	Definiert den Schrittmodus, entweder über Addition und Subtraktion oder über Multiplikation	AdditionAndSubtraction
valueStateText	Bestimmt den Text, der zum valueState (Status des Inputs) angezeigt werden soll
valueState	Bestimmt den Status des Inputs mit möglichen Eingabewerten: Error, Warning, Success, Information, None	None
textAlign	Ausrichtung des Texts im Input mit möglichen Werten: Begin, End, Left, Right, Center, Initial
visible	Gibt an, ob die Komponente angezeigt werden soll	true
spanS	Gibt die Breite des Controls im Grid-Layout an. Definiert, wie viele Spalten eingenommen werden sollen	12
spanM	Gibt die Breite des Controls im Grid-Layout an. Definiert, wie viele Spalten eingenommen werden sollen	12
spanL	Gibt die Breite des Controls im Grid-Layout an. Definiert, wie viele Spalten eingenommen werden sollen	12
spanXL	Gibt die Breite des Controls im Grid-Layout an. Definiert, wie viele Spalten eingenommen werden sollen	12

Methode	Beschreibung
GET_ENABLED	Lesen des Aktivitätsstatus‘
GET_MAX	Lesen des maximal erlaubten Wertes
GET_MIN	Lesen des minimal erlaubten Wertes
GET_PLACEHOLDER	Lesen des Platzhalters
GET_STEP	Lesen der Schrittweite
GET_STEPMODE	Lesen des Schrittmodus‘
GET_TEXT_ALIGN	Lesen der Textausrichtung
SET_ENABLED	Setzen des Aktivitätsstatus‘
SET_MAX	Setzen des maximal erlaubten Wertes
SET_MIN	Setzen des minimal erlaubten Wertes
SET_PLACEHOLDER	Setzen des Platzhalters
SET_STEP	Setzen der Schrittweite
SET_STEPMODE	Setzen des Schrittmodus‘
SET_TEXT_ALIGN	Setzen der Textausrichtung

Lesen des Aktivitätsstatus‘.

Rückgabeparameter	Typ	Beschreibung
RV_VALUE	BOOLE_D	Aktivitätsstatus

GET_MAX

Lesen des maximal erlaubten Wertes.

Rückgabeparameter	Typ	Beschreibung
RV_VALUE	DECFLOAT34	Maximal erlaubter Wert

GET_MIN

Lesen des minimal erlaubten Wertes.

Rückgabeparameter	Typ	Beschreibung
RV_VALUE	DECFLOAT34	Minimal erlaubter Wert

GET_PLACEHOLDER

Lesen des Platzhalters.

Rückgabeparameter	Typ	Beschreibung
RV_VALUE	String	Gesetzter Platzhalter

GET_STEP

Lesen der Schrittweite.

Rückgabeparameter	Typ	Beschreibung
RV_VALUE	DECFLOAT34	Gesetzte Schrittweite

GET_STEPMODE

Lesen des Schrittmodus‘. Hier besteht die Wahl zwischen „AdditionAndSubtraction“ und „Multiple“.

Rückgabeparameter	Typ	Beschreibung
RV_STEP_MODE	String	Gesetzter Schrittmodus

GET_TEXT_ALIGN

Lesen der Textausrichtung. Hier existieren mögliche Werte „Begin“, „End“, „Left“, „Right“, „Center“, „Initial“.

Rückgabeparameter	Typ	Beschreibung
RV_TEXT_ALIGN	String	Gesetzte Textausrichtung

SET_ENABLED

Setzen des Aktivitätsstatus‘.

Übergabeparameter	Typ	Standardwert	Beschreibung
IV_VALUE	BOOLE_D		Zu setzender Aktivitätsstatus

Rückgabeparameter	Typ	Beschreibung
RO_CONTROL	Step Input	Referenz zu this, um Methodenverkettung zu erlauben

SET_MAX

Setzen des maximal erlaubten Wertes.

Übergabeparameter	Typ	Standardwert	Beschreibung
IV_VALUE	DECFLOAT34		Zu setzender maximaler Wert

Rückgabeparameter	Typ	Beschreibung
RO_CONTROL	Step Input	Referenz zu this, um Methodenverkettung zu erlauben

SET_MIN

Setzen des minimal erlaubten Wertes.

Rückgabeparameter	Typ	Beschreibung
IV_VALUE	DECFLOAT34	Zu setzender minimaler Wert

Rückgabeparameter	Typ	Beschreibung
RO_CONTROL	Step Input	Referenz zu this, um Methodenverkettung zu erlauben

SET_PLACEHOLDER

Setzen des Platzhalters.

Übergabeparameter	Typ	Standardwert	Beschreibung
IV_VALUE	String		Zu setzender Text für den Platzhalter

Rückgabeparameter	Typ	Beschreibung
RO_CONTROL	Step Input	Referenz zu this, um Methodenverkettung zu erlauben

SET_STEP

Setzen der Schrittweite.

Übergabeparameter	Typ	Standardwert	Beschreibung
IV_VALUE	DECFLOAT34		Zu setzende Schrittweite

Rückgabeparameter	Typ	Beschreibung
RO_CONTROL	Step Input	Referenz zu this, um Methodenverkettung zu erlauben

SET_STEPMODE

Setzen des Schrittmodus‘. Hier besteht die Wahl zwischen „AdditionAndSubtraction“ und „Multiple“.

Übergabeparameter	Typ	Standardwert	Beschreibung
IV_STEP_MODE	String		Zu setzender Schrittmodus

Rückgabeparameter	Typ	Beschreibung
RO_CONTROL	Step Input	Referenz zu this, um Methodenverkettung zu erlauben

SET_TEXT_ALIGN

Setzen der Textausrichtung. Hier existieren mögliche Werte „Begin“, „End“, „Left“, „Right“, „Center“, „Initial“.

Übergabeparameter	Typ	Standardwert	Beschreibung
IV_TEXT_ALIGN	String		Zu setzender Schrittmodus

Rückgabeparameter	Typ	Beschreibung
RO_CONTROL	Step Input	Referenz zu this, um Methodenverkettung zu erlauben

Spacer

Switch