TextEditSettings.MaskType Property

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

Namespace: DevExpress.Xpf.Editors.Settings

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

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public MaskType MaskType { get; set; }

VB.NET

Public Property MaskType As MaskType

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

To learn more, see Masked Input.

Example

Xaml

<dxg:GridControl ItemsSource="{Binding Customers}">
    <dxg:GridControl.View>
        <dxg:TableView />
    </dxg:GridControl.View>
    <dxg:GridColumn FieldName="Name"/>
    <dxg:GridColumn FieldName="City"/>
    <dxg:GridColumn FieldName="Birthday">
        <dxg:GridColumn.EditSettings>
            <dxe:TextEditSettings Mask="d" MaskType="DateTime" MaskUseAsDisplayFormat="True"/>
        </dxg:GridColumn.EditSettings>
    </dxg:GridColumn>
</dxg:GridControl>

Related GitHub Examples

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.

XAML

wpf-data-grid-refresh-on-timer/CS/RefreshOnTimer/MainWindow.xaml#L22

<Setter.Value>
    <dxe:TextEditSettings MaskType="Numeric" Mask="f" MaskUseAsDisplayFormat="True" />
</Setter.Value>

Reporting_how-to-remove-standard-bar-items-and-add-custom-ones-to-the-documentviewer-toolbar-e2974/CS/WpfApplication1/MainWindow.xaml#L152

<dxb:BarEditItem.EditSettings>
    <dxe:TextEditSettings AllowNullInput="True" HorizontalContentAlignment="Center" MaskType="RegEx" Mask="\d{0,6}"/>
</dxb:BarEditItem.EditSettings>

how-to-specify-editors-for-displayed-properties-t324581/CS/MainWindow.xaml#L27

<dxprg:PropertyDefinition.EditSettings>
    <dxe:TextEditSettings MaskType="Simple" Mask="[phone]"/>
</dxprg:PropertyDefinition.EditSettings>

how-to-bind-a-grid-control-to-the-worksheet-data-wpf-spreadsheet-t461395/CS/WpfSpreadsheet_DataBinding/MainWindow.xaml#L26

<Style x:Key="TextEditSettingsStyle" TargetType="{x:Type dxe:TextEditSettings}">
    <Setter Property="MaskType" Value="Numeric"/>
    <Setter Property="MaskUseAsDisplayFormat" Value="True"/>

how-to-bind-the-chartcontrol-to-the-gridcontrol-visibleitems-collection/CS/VisibleItemsSample/MainWindow.xaml#L33

<dxg:GridColumn.EditSettings>
    <dxe:TextEditSettings Mask="p" MaskType="Numeric" MaskUseAsDisplayFormat="True" />
</dxg:GridColumn.EditSettings>