EditorShowMode Enum

Contains values that specify how an in-place editor is activated for a cell in a container control.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v20.1.dll

Declaration

public enum EditorShowMode
Public Enum EditorShowMode

Members

Name Description
Default

Specifies the default behavior.

For the Grid Control, the Default value is equivalent to:

For the PivotGrid control, this option acts as the EditorShowMode.MouseDownFocused option.

MouseDown

A cell's in-place editor is activated when the left mouse button is pressed.

MouseUp

A cell's in-place editor is activated when a mouse button is released from a click within the cell.

Click

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

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

Remarks

In-place editors within container controls can be invoked when a mouse button is pressed, released or on a subsequent mouse click. A control that supports these modes provides a property of the EditorShowMode class (for instance, ColumnViewOptionsBehavior.EditorShowMode in the XtraGrid).

Choosing an in-place editor activation mode depends on usability requirements and any additional functionality that should be implemented. For instance, if drag and drop of rows must be supported in a container control you can choose the EditorShowMode.MouseUp or EditorShowMode.Click mode to open editors (in the EditorShowMode.MouseDown mode a drag and drop operation cannot be initiated because an in-place editor is activated once a cell is clicked).

See Also