Tag

ColumnBase.EditSettings Property

Gets or sets an object that contains the column editor’s settings. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v21.1.Core.dll

Declaration

public BaseEditSettings EditSettings { get; set; }

Property Value

Type Description
BaseEditSettings

A BaseEditSettings descendant that specifies the column’s editor.

Remarks

The Assign Editors to Cells topic lists alternative approaches to customization of column editors.

Run Demo: Cell Editors

The GridControl automatically creates an editor for a column based on its value type. For example, if a column is bound to a DateTime field, the GridControl creates a date editor for it. If a column is bound to a numeric field, the numeric editor is used. Otherwise, the text editor is used.

Each editor has a helper class responsible for the editor’s functionality:

Use the column’s EditSettings property to specify an in-place editor for a column.

The following code sample shows how to assign a spin editor to the UnitPrice column:

View Example

<dxg:GridColumn x:Name="colUnitPrice" FieldName="UnitPrice">
    <dxg:GridColumn.EditSettings>
        <dxe:SpinEditSettings MaxValue="999" MinValue="1" DisplayFormat="c2"/>
    </dxg:GridColumn.EditSettings>
</dxg:GridColumn>

When the same editor is used in multiple locations, the GridControl uses the helper class to paint its cells. The actual editors are only created when the user starts to edit a cell. When editing is completed, the editors are automatically deleted. This improves the application’s performance.

To obtain a column’s actual editor, use the ColumnBase.ActualEditSettings property. This property returns the editor’s helper class that defines the editor’s functionality and behavior.

Use the BaseEditSettings.CreateEditor method to create an editor from an EditSettings object programmatically.

Automatic Filter Row

The EditSettings property affects the Automatic Filter Row. Specify the CellTemplate to assign a different editor for data cells:

 <dxg:GridColumn FieldName="Date">
    <!-- Automatic Filter Row uses TextEdit -->
    <dxg:GridColumn.EditSettings>
        <dxe:TextEditSettings/>
    </dxg:GridColumn.EditSettings>
    <!-- Data cells use DateEdit -->
    <dxg:GridColumn.CellTemplate>
        <DataTemplate>
            <dxe:DateEdit x:Name="PART_Editor"/>
        </DataTemplate>
    </dxg:GridColumn.CellTemplate>
</dxg:GridColumn>
See Also