DataViewBase.EditorShowMode Property

Gets or sets a value which specifies how a cell editor is activated by the mouse. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

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

Declaration

C#

public EditorShowMode EditorShowMode { get; set; }

VB.NET

Public Property EditorShowMode As EditorShowMode

Property Value

Type	Description
EditorShowMode	A EditorShowMode enumeration value which specifies how a cell editor is activated by the mouse.

Available values:

Name	Description
Default	Specifies the default behavior. For the GridControl, this option acts as the EditorShowMode.MouseDown option. If the grid functions in marquee selection mode or the multiple cell selection is enabled, this option acts as the EditorShowMode.MouseUpFocused.
MouseDown	A cell’s in-place editor is activated when the left mouse button is pressed.
MouseDownFocused	If a cell is focused and not being edited, an in-place editor is opened on pressing the mouse button. Clicking a non-focused cell focuses the cell first, and a subsequent mouse-down event activates the in-place editor (if not prohibited).
MouseUp	A cell’s in-place editor is activated when a mouse button is released from a click within the cell.
MouseUpFocused	If a cell is focused and not being edited, an in-place editor is opened on a click (the mouse button is pressed and then released). Clicking a non-focused cell focuses the cell first, and a subsequent click activates the in-place editor (if not prohibited).

Remarks

See the EditorShowMode topic for information on the available editor activation modes.

If in-place editors must not be invoked on the first click (useful for browsing records with data editing support), set the EditorShowMode property to EditorShowMode.MouseUpFocused.

To support drag and drop operations within a View, set the EditorShowMode property to either EditorShowMode.MouseUp or EditorShowMode.MouseUpFocused.

Note that in EditorShowMode.MouseDown and EditorShowMode.MouseDownFocused modes, the first click on a cell opens the editor, and then this mouse event is passed to the activated editor. For instance, if an in-place editor represents a ComboBoxEdit control, clicking a cell activates the editor and immediately opens its drop-down.

In EditorShowMode.MouseUp and EditorShowMode.MouseUpFocused modes, the first click on a cell is not passed to the cell’s in-place editor. For instance, in EditorShowMode.MouseUp mode, if an in-place editor represents a ComboBoxEdit control, the first click activates the editor. The editor’s dropdown is opened by the second click.

If the Selection Rectangle feature is enabled (the DataViewBase.ShowSelectionRectangle property is set to true), and the EditorShowMode property is set to EditorShowMode.Default, the grid will display editors only for a focused row. This means that in order to edit a cell value, your end-users should click a required cell/row to focus it, then click the required cell again to activate its editor and edit a cell value.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the EditorShowMode 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#

drag-drop-in-treelist-and-gridcontrol-how-to-show-dragged-rows-as-a-cursor-e4165/CS/DragDropRows/MainWindow.xaml#L33

<dxg:GridControl.View>
    <dxg:TableView Name="tableView1" ShowTotalSummary="True" MultiSelectMode="Row" EditorShowMode="MouseUpFocused" ShowGroupPanel="False" />
</dxg:GridControl.View>

how-to-resize-columns-when-column-headers-are-hidden-t284142/CS/WpfApplication6/MainWindow.xaml#L17

<grd:GridControl.View>
    <grd:TableView ShowColumnHeaders="False" x:Name="gridView" EditorShowMode="MouseUpFocused">
        <grd:TableView.CellTemplate>

how-to-add-incremental-search-into-gridcontrol-t163003/CS/IncrementalSearch/MainWindow.xaml#L18

<dxg:GridControl.View>
    <dxg:TableView x:Name="tableView1" EditorShowMode="MouseDownFocused"/>
</dxg:GridControl.View>

how-to-add-draganddrop-capability-to-the-detail-grid-t163179/CS/DragAndDropExample/MainWindow.xaml#L15

<dxg:GridControl.View>
    <dxg:TableView EditorShowMode="MouseDownFocused"/>
</dxg:GridControl.View>

how-to-implement-the-drag-and-drop-to-re-order-and-drop-rows-onto-an-external-control-e1194/VB/VB/How to TreeList Drag and Drop/MainWindow.xaml#L18

<dxg:TreeListControl.View>
    <dxg:TreeListView Name="treeListView1" KeyFieldName="ID" ParentFieldName="ParentID" EditorShowMode="MouseUpFocused" AutoExpandAllNodes="True" />
</dxg:TreeListControl.View>