Skip to main content

DevExpress v24.1 Update — Your Feedback Matters

Our What's New in v24.1 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

MaskProperties.MaskType Property

Gets or sets the mask type.

Namespace: DevExpress.XtraEditors.Mask

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

public virtual MaskType MaskType { get; set; }

#Property Value

Type Default Description
MaskType None

A MaskType value specifying the mask type used.

Available values:

Name Description
None

Specifies that the mask feature is disabled.

DateTime

Specifies that the editor should accept date/time values and that the mask string must use the DateTime format syntax.

DateTimeAdvancingCaret

The DateTime mask mode with the caret automatic movement feature.

After an end-user enters and completes a specific portion of a date/time value the caret automatically moves to the following part of the date/time value that can be edited.

Numeric

Specifies that the editor should accept numeric values and that the mask string must use the Numeric format syntax.

RegEx

Specifies that the mask should be created using full-functional regular expressions.

Regular

Specifies that the mask should be created using simplified regular expression syntax.

Simple

Specifies that the mask should use the simplified syntax.

Custom

Specifies that the editor uses a custom mask manager.

To implement a custom mask manager which will deal with masks in a custom manner create a custom editor and override its CreateMaskManager method. This method should then supply a custom mask manager when the MaskProperties.MaskType property is set to Custom.

TimeSpan

Specifies that the editor should accept time span values.

TimeSpanAdvancingCaret

Specifies that the editor should accept time span values. Supports the caret automatic movement feature.

#Remarks

Refer to the Input Mask document for information on choosing the mask type that meets your requirements.

The mask expression should be constructed using the syntax that is determined by the mask type. Use the MaskProperties.EditMask property to specify the mask expression.

The following code snippets (auto-collected from DevExpress Examples) contain references to the MaskType property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also