Text Format Editor
Reference documentation for the Text Format Editor
Last updated
Reference documentation for the Text Format Editor
Last updated
The Text Format Editor allows displaying any text (including user input) with a specific format automatically based on how the format is configured in Design time.
It can be used in any place where there is a format
property:
Form components like , , ,
Text Columns in the
Text Columns in Grid components like , ,
It's located at the top of the editor and it allows modifying the value before applying the format to display and before storing the value in the data provider.
There are three pre-defined options that allow you to easily configure the format:
All Uppercase, will set the format to show any text in uppercase, if it's an input component will convert any entered text to uppercase
All Lowercase, the same as the one above but in lowercase
Only Numbers, will set the format to only numbers, if it's an input component it won't allow entering letters or other characters
The three options above can be combined with the Max Length field which will limit the number of characters displayed, and if it's an input component it will limit the user input as well.
There is a fourth format option with advanced capabilities, Display Format, which allows entering any pattern to either display a text or limit user input. This option cannot be combined with Max Length because the pattern also defines the length of the text displayed and allowed on input components.
Once the pattern is defined it allows extra modifications using the fields below:
PlaceHolder, it's the text used by input components to be displayed as a help for the expected format when the entered value doesn't match the pattern
Allowed Characters for *
, when the pattern uses the *
symbol means that any character is accepted in that position but this option can limit the exact characters allowed.
i.e. xyz
indicates that the entered value can only contain x
, y
, or z
where *
is used
Raw value, when this checkbox is marked any characters that are not part of the pattern are not stored in the data provider.
i.e. the pattern #-#
will show and store one digit (0-9) followed by a dash and another digit, but if this checkbox is marked it will store only the two digits
This is a helper list with all the special characters that can be used to define the pattern in the most advanced format option Display Format