Mask Editing Overview
- 2 minutes to read
The DevExpress editors allow you to use masks during editing. Masks are useful when a string entered by an end-user into an editor matches a specific format. For instance, a text editor that accepts date/time values in the 24-hour format only, or only numeric values, or a phone number that only allows an end-user to enter digits into automatically constructed placeholders.
Within the ASPxEditors Suite, masked input is supported by the following editor types.
Text box editors (in particular, the ASPxTextBox and ASPxButtonEdit).
Mask settings can be accessed via the ASPxTextBox.MaskSettings (ASPxButtonEdit.MaskSettings) property. The editor’s mask can be specified via the MaskSettings.Mask property.
Date editors (ASPxDateEdit).
To enable masked input in a date editor, the ASPxDateEdit.UseMaskBehavior property should be set to true. The mask can be defined via the ASPxDateEdit.EditFormatString property, if the ASPxDateEdit.EditFormat property is set to EditFormat.Custom.
Note
Defining a text box editor’s mask via the editor’s MaskSettings.Mask property automatically activates the editor’s built-in validation functionality. This might affect the editor’s appearance, because some extra space might be occupied for an error image and text to be displayed for invalid input, which is due to an editor’s default validation settings. To customize the editor appearance in this case, use validation properties available via the editor’s ASPxEdit.ValidationSettings property (for instance, you can modify the ValidationSettings.Display or ValidationSettings.ErrorDisplayMode property, etc). You can also provide a mask-specific error text via the MaskSettings.ErrorText property of an editor.