Text Format Editor

Reference documentation for the Text Format Editor

Overview

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.

Text Format Editor

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 , ,

Sections

UI Converter

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.

Use UI Converter option

Format Options

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

Legend

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