Skip to main content

TextEdit.MaskType Property

Gets or sets the mask type. This is a dependency property.

Namespace: DevExpress.Xpf.Editors

Assembly: DevExpress.Xpf.Core.v24.1.dll

NuGet Package: DevExpress.Wpf.Core

Declaration

public MaskType MaskType { get; set; }

Property Value

Type Description
MaskType

One of the MaskType enumeration values.

Available values:

Show 16 items
Name Description
None

The masked input is disabled.

DateTime

The editor accepts date/time values. The mask string must use the DateTime format syntax.

DateTimeAdvancingCaret

The DateTime mask with automatic navigation between mask parts.

If a user completes a part of the value, the caret moves to the next editable part.

DateOnly

The editor accepts date values. The mask string must use the DateOnly format syntax (.NET 6.0+ required).

DateOnlyAdvancingCaret

The DateOnly mask with automatic navigation between mask parts.

If a user completes a part of the value, the caret moves to the next editable part.

DateTimeOffset

The editor accepts date/time values with the timezone offset. The mask string must use the DateTimeOffset format syntax.

DateTimeOffsetAdvancingCaret

The DateTimeOffset mask with automatic navigation between mask parts.

If a user completes a part of the value, the caret moves to the next editable part.

TimeOnly

The editor accepts time values. The mask string must use the TimeOnly format syntax (.NET 6.0+ required).

TimeOnlyAdvancingCaret

The TimeOnly mask with automatic navigation between mask parts.

If a user completes a part of the value, the caret moves to the next editable part.

Numeric

The editor accepts numeric values. The mask string must use the Numeric format syntax.

RegEx

The mask should use the full-functional regular expressions.

Regular

The mask should use the simplified regular expression syntax.

Simple

The mask should use the simplified syntax.

TimeSpan

The editor accepts time interval values. The mask string must use the TimeSpan format syntax.

TimeSpanAdvancingCaret

The TimeSpan mask with automatic navigation between mask parts.

If a user completes a part of the value, the caret moves to the next editable part.

Custom

Applies the mask specified in the CustomMask event.

Remarks

Note

The following TextEdit descendants do not support the masked input:

Specify Mask Type in Design Time

You can use the Mask Editor to specify editor’s MaskType.

Specify Mask Type in Code

<!-- Long date -->
<dxe:TextEdit Mask="D" MaskType="DateTime"
    MaskUseAsDisplayFormat="True" />
<!-- Currency -->
<dxe:TextEdit Mask="c" MaskType="Numeric"
    MaskUseAsDisplayFormat="True" />
<!-- Email address -->
<dxe:TextEdit Mask="[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}"
    MaskType="RegEx" MaskUseAsDisplayFormat="True" />

To learn more, see Mask Types.

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