Textbox

FeatureDescription
TextDetermines the text.
FormatDefines the formatting for numbers.

We use the library numeral.js for formatting.
We therefore refer you to the page http://numeraljs.com/#format for an explanation of valid formatting.

Dependence on the InputType
Even though only numbers can be formatted, this property is available for both numeric and alphanumeric text boxes.

However, there are differences in which formatting is permitted.

For numeric text boxes, the format may only contain the following characters:

+

0
.
[
]

There is no restriction for alphanumeric text boxes.

Prefixes and suffixes
For alphanumeric text boxes, it is also possible to specify a prefix and or suffix in the format.
To prefix a number with a specific character string, the character string must be added to the format in curly brackets.
To append a specific character string to a number, the character string must be added to the format in curly brackets.
Example:
A number is to be displayed as a temperature with one decimal place.
Input: 12
Format: 0.0{ °C}
Output: 12.0 °C

Please note that any spaces that are to be displayed between the number and prefix/suffix must be specified within the curly brackets. Spaces between the format and curly brackets are ignored.
InputTypeDefines the type of text displayed.
Depending on the selected type, a layout adapted to the input type appears when using the on-screen keyboard.
Possible values are:
Numeric
AlphaNumeric

An alphanumeric text box allows all characters to be entered.
Validation of the input is possible using regular expressions (see Regex property).

A numeric text box, on the other hand, only allows digits, plus/minus signs and decimal separators.
In addition to validation using regular expressions, the content of numeric text boxes can also be checked for a range of values (see Min and Max properties).
MinUsed, together with “Max“, to validate numerical text boxes.

Specifies the smallest value still permitted for this text box. If a number is smaller than this value, the text box is marked with a red frame,
and the value of the “Text” property can no longer be used to write variables or other properties.

If both properties “Min” and “Max” are set to 0, validation is deactivated.
MaxUsed, together with “Min“, to validate numeric text boxes.

Specifies the largest permitted value for this text box. If a number is greater than this value, the text box is marked with a red frame,
and the value of the “Text” property can no longer be used to write variables or other properties.

If both properties “Min” and “Max” are set to 0, validation is deactivated.
RegexUsed to validate text boxes using regular expressions.

Regular expressions can be used to perform complex checks on character strings. Here are just two links, as the explanation of regular expressions is not part of this documentation:

https://de.wikipedia.org/wiki/Regul%C3%A4rer_Ausdruck

For testing/developing/learning regular expressions:
https://regexr.com/

The following applies to formatted text boxes: The regular expression is checked after the format has been applied.

If the content of the text box does not correspond to the regular expression, the text box is marked with a red frame,
and the value of the “Text” property can no longer be used to write variables or other properties.
MaxCharsSpecify the number of characters for the text field. If the value is 0, no character limits are set.
IsReadOnlyHere you can set whether it is possible to write in the text box or whether only reading is possible. Options: True | False
FontDetermines the font
> Make sure that the selected font is also installed on the target system. Otherwise a default font will be displayed.
FontSizeDetermines the font size.
TextColorDetermines the font color.
TextAlignmentDetermines the alignment of the text. Options: left-aligned | right-aligned | centered
TextBackroundColorDetermines the background color on which the text is written.
ActionDescription
ClickedAn action can be defined here that is triggered when the element is clicked with the mouse button.