GridOptionsNavigation.EnterMoveNextColumn Property

Gets or sets whether an Enter key press moves focus to the next cell.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v25.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(false)]
[XtraSerializableProperty]
public virtual bool EnterMoveNextColumn { get; set; }

VB.NET

<DefaultValue(False)>
<XtraSerializableProperty>
Public Overridable Property EnterMoveNextColumn As Boolean

Property Value

Type	Default	Description
Boolean	false	true if Enter moves focus to the next cell; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to EnterMoveNextColumn
GridView	.OptionsNavigation .EnterMoveNextColumn
WinExplorerView	.OptionsNavigation .EnterMoveNextColumn

Remarks

When the user presses Enter in the active editor, changes are saved and the editor closes. Activate the EnterMoveNextColumn property to move focus to the next cell and activate its editor on Enter. Note that focus moves even if the next cell cannot be edited.

Multi-line editors use Enter to return the carriage, not to save changes. If the next cell uses a MemoEdit or MemoExEdit, set the AcceptsReturn property to false to prevent the editor from handling Enter.

The New Item Row allows users to add a new row. To display the New Item Row, use the GridView.OptionsView.NewItemRowPosition property.

When a user presses Enter in this row, focus always moves to the next cell regardless of the EnterMoveNextColumn property value. When the user presses Enter in the last cell, a new row is created. To create a new row when the user presses Enter in any cell, not only in the last one, handle the ProcessGridKey event as shown below.

C#

using DevExpress.XtraGrid;
using DevExpress.XtraGrid.Views.Grid;

gridControl.ProcessGridKey += GridControl_ProcessGridKey;

private void GridControl_ProcessGridKey(object sender, KeyEventArgs e) {
    var view = (sender as GridControl).MainView as GridView;
    if (e.KeyCode == Keys.Enter && view.IsNewItemRow(view.FocusedRowHandle)) {
        view.PostEditor();
        view.UpdateCurrentRow();
        e.Handled = true;
    }
}

VB.NET

Imports DevExpress.XtraGrid
Imports DevExpress.XtraGrid.Views.Grid

AddHandler gridControl.ProcessGridKey, AddressOf GridControl_ProcessGridKey

Private Sub GridControl_ProcessGridKey(ByVal sender As Object, ByVal e As KeyEventArgs)
    Dim view = TryCast((TryCast(sender, GridControl)).MainView, GridView)
    If e.KeyCode = Keys.Enter AndAlso view.IsNewItemRow(view.FocusedRowHandle) Then
        view.PostEditor()
        view.UpdateCurrentRow()
        e.Handled = True
    End If
End Sub