ColumnViewOptionsBehavior.EditorShowMode Property

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

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v20.1.dll

Declaration

[DefaultValue(EditorShowMode.Default)]
[XtraSerializableProperty]
public virtual EditorShowMode EditorShowMode { get; set; }
<DefaultValue(EditorShowMode.Default)>
<XtraSerializableProperty>
Public Overridable Property EditorShowMode As EditorShowMode

Property Value

Type Default Description
EditorShowMode

Default

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

Property Paths

You can access this nested property as listed below:

Show 15 property paths
Object Type Path to EditorShowMode
AdvBandedGridView
.OptionsBehavior.EditorShowMode
AdvBandedGridView
.OptionsBehavior.EditorShowMode
BandedGridView
.OptionsBehavior.EditorShowMode
BandedGridView
.OptionsBehavior.EditorShowMode
ColumnView
.OptionsBehavior.EditorShowMode
CardView
.OptionsBehavior.EditorShowMode
CardView
.OptionsBehavior.EditorShowMode
GridView
.OptionsBehavior.EditorShowMode
GridView
.OptionsBehavior.EditorShowMode
LayoutView
.OptionsBehavior.EditorShowMode
LayoutView
.OptionsBehavior.EditorShowMode
TileView
.OptionsBehavior.EditorShowMode
TileView
.OptionsBehavior.EditorShowMode
WinExplorerView
.OptionsBehavior.EditorShowMode
WinExplorerView
.OptionsBehavior.EditorShowMode

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

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

If the EditorShowMode property is set to EditorShowMode.Default, the actual editor activation mode is determined by the current multiple selection mode. See the EditorShowMode.Default topic for more information.

IMPORTANT

Starting with version 18.2, Auto Filter Row cells always invoke their editors on user clicks regardless of the EditorShowMode property value (i.e., these cells always function in the EditorShowMode.MouseDown mode). Currently, there is no option to revert this change back to the v18.1 state, but you can handle the ColumnView.ShownEditor event and manually select all cell text to allow end-users type in search criteria immediately after they click an Auto Filter Row cell.


private void GridView1_ShownEditor(object sender, EventArgs e)
{
     GridView view = sender as GridView;
     if(view.IsFilterRow(view.FocusedRowHandle))
     {
         view.ActiveEditor.MouseUp += Edit_MouseUp;
     }
}

private void Edit_MouseUp(object sender, MouseEventArgs e)
{
     TextEdit edit = sender as TextEdit;
     edit.SelectAll();
     edit.MouseUp -= Edit_MouseUp;
}

Note that in MouseDown mode, 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 ImageComboBoxEdit control, clicking a cell activates the editor and immediately opens its dropdown. In Click and MouseUp modes, the first click on a cell is not passed to the cell's in-place editor. For instance, in MouseUp mode, if an in-place editor represents a ImageComboBoxEdit control, the first click activates the editor. The editor's dropdown is opened by the second click.

If the CTRL, ALT or SHIFT modifier key is pressed while clicking a cell, the cell is focused, but the cell editor is not activated.

See Also