Skip to main content

Masked Input in DevExpress Data Editors for .NET MAUI

  • 2 minutes to read

TextEdit supports input masks. A mask defines a pattern for the entered string. You can use it when a text editor should accept a fixed-length string in a pre-defined format (for example, a phone number, zip code, and so on).

Text Editor Mask

Use the Mask property to specify the mask expression. It can include meta and literal characters.

  • A metacharacter is a user input placeholder (identified by the underscore character - _). Use the MaskPlaceholderChar and PlaceholderColor properties to change the character and its color.

    The following table lists the available metacharacters:

    Character Description
    L An alphabetic character. For example, A-Z, a-z for the USA.
    0 A numeric character.
    C Any character.
  • A literal character is a fixed part of the mask that cannot be edited by users. To display a metacharacter as a literal, precede it with a backslash (/).

The following example configures an input mask for a text editor:

<dxe:TextEdit Mask="+1 (000) 000-0000" 
              MaskPlaceholderChar="#">
</dxe:TextEdit>

You can also validate editor values once they are being committed to the data source. For more information, refer to the following help topic: Data Validation in DevExpress Data Editors for .NET MAUI.

To specify how numeric and date editors display their values in not focused state, define the NumericEdit.DisplayFormat or DateEdit.DisplayFormat property.