TextEditSettings.MaskUseAsDisplayFormat Property

Gets or sets whether display values are still formatted using the mask when the editor is not focused. This is a dependency property.

Namespace: DevExpress.Xpf.Editors.Settings

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

Declaration

C#

public bool MaskUseAsDisplayFormat { get; set; }

VB.NET

Public Property MaskUseAsDisplayFormat As Boolean

Property Value

Type	Description
Boolean	true if the mask settings are used to format display values when the editor is not focused; false if the settings specified by the BaseEditSettings.DisplayFormat property are used.

Property Paths

You can access this nested property as listed below:

Object Type	Path to MaskUseAsDisplayFormat
TokenEditorBehavior	.NewTokenEditSettings.MaskUseAsDisplayFormat

Remarks

Set the MaskUseAsDisplayFormat property to true to use the editor’s mask settings to format its display text when the editor is not focused. As a result, the editor’s text in edit and display modes will be identical.

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 MaskUseAsDisplayFormat 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.

C#

how-to-style-gridcontrols-summary-items-separately-when-summary-items-are-aligned-by-columns-e4998/VB/DXSample/MainWindow.xaml#L37

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

Reporting_wpf-end-user-report-designer-how-to-hide-a-property-in-the-properties-window-t285448/CS/Dictionary1.xaml#L171

<dxpg:PropertyDefinition.EditSettings>
    <dxe:TextEditSettings MaskType="RegEx" Mask="{x:Static propertygrid:ReportDesignerPropertyGridControl.PageRangeMask}" MaskUseAsDisplayFormat="True" />
</dxpg:PropertyDefinition.EditSettings>

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

<Setter Property="MaskType" Value="Numeric"/>
<Setter Property="MaskUseAsDisplayFormat" Value="True"/>
<Setter Property="Mask" Value="c"/>

how-to-group-gridcontrol-by-multiple-values-the-multi-value-grouping-demo-v162-and-lower-t513354/CS/DXApplication3/MainWindow.xaml#L34

                      Mask="P0"
                      MaskUseAsDisplayFormat="True">
</dxe:SpinEditSettings>

how-to-bind-to-infinitesource/CS/MainWindow.xaml#L20

<dxg:GridColumn.EditSettings>
    <dxe:DateEditSettings Mask="H:mm MM/dd/yy" MaskUseAsDisplayFormat="True"/>
</dxg:GridColumn.EditSettings>