BaseEditSettings.DisplayFormat Property

Gets or sets the pattern used to format the editor’s display value. This is a dependency property.

Namespace: DevExpress.Xpf.Editors.Settings

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

Declaration

C#

public string DisplayFormat { get; set; }

VB.NET

Public Property DisplayFormat As String

Property Value

Type	Description
String	A String value that is the format pattern.

Property Paths

You can access this nested property as listed below:

Object Type	Path to DisplayFormat
BarEditItem	.EditSettings.DisplayFormat
FilterField	.EditSettings.DisplayFormat
TokenEditorBehavior	.TokenEditSettings.DisplayFormat
GanttColumn	.ActualEditSettings.DisplayFormat
ColumnBase	.ActualEditSettings.DisplayFormat
GridColumn	.ActualEditSettings.DisplayFormat
TreeListColumn	.ActualEditSettings.DisplayFormat
CollectionDefinition	.EditSettings.DisplayFormat
PropertyDefinition	.EditSettings.DisplayFormat
SpreadsheetCustomCellEditEventArgs	.EditSettings.DisplayFormat

Remarks

Use the DisplayFormat property to format the editor’s value or add any text. The formatted text is displayed if the editor’s value is not being edited (the editor is not focused or the value is read-only).

For example, set the DisplayFormat property to c2 to display currency values. If the editor’s value is 99.9, its formatted equivalent is $99.90.

Note

An editor’s value is formatted using string.Format(“{0:DisplayFormat}”, BaseEdit.EditValue). The display format should match the value’s type (see Example 1); otherwise, the format is ignored (see Example 2).

Example 1

XAML

<dxe:ButtonEdit DisplayFormatString="c2" IsReadOnly="True">
    <dxe:ButtonEdit.EditValue>
        <sys:Double>99.9</sys:Double>
    </dxe:ButtonEdit.EditValue>
</dxe:ButtonEdit>

Example 2

XAML

<dxe:ButtonEdit DisplayFormatString="c2" IsReadOnly="True" EditValue="99.9" />

Note

Refer to the Format Specifiers topic for more information on the available DisplayFormat values.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DisplayFormat 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-use-custom-editors-to-edit-cell-values-e1596/CS/Window1.xaml#L18

<dxg:GridColumn.EditSettings>
    <dxe:SpinEditSettings DisplayFormat="c2" MinValue="1" MaxValue="999" />
</dxg:GridColumn.EditSettings>

how-to-create-unbound-columns-e1503/CS/DXGrid_UnboundColumns/Window1.xaml#L15

<dxg:GridColumn.EditSettings>
    <dxe:TextEditSettings DisplayFormat="c2" />
</dxg:GridColumn.EditSettings>

how-to-show-the-appointments-search-result-in-searchresult-view-for-schedulercontrol-simil-t278605/CS/SearchResultViewDemo/SearchResultView.xaml#L20

<dxg:GridColumn.EditSettings>
    <dxe:DateEditSettings DisplayFormat="{}{0:yyyy/MM/d HH:mm:ss}"/>
</dxg:GridColumn.EditSettings>

how-to-automatically-generate-columns-with-predefined-settings-mvvm-e3330/CS/ColumnTemplateSelectorExample/MainPage.xaml#L48

<dxg:GridColumn.EditSettings>
    <dxe:SpinEditSettings IsFloatValue="False" DisplayFormat="{Binding Control.Name}"/>
</dxg:GridColumn.EditSettings>

how-to-implement-custom-grouping-e1530/CS/DXGrid_CustomGrouping/Window1.xaml#L18

<dxg:GridColumn.EditSettings>
    <dxe:SpinEditSettings DisplayFormat="c2" />
</dxg:GridColumn.EditSettings>