GridView.ShowEditor() Method

Invokes the focused cell’s editor.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v22.2.dll

NuGet Package: DevExpress.Win.Grid

Declaration

C#

public override void ShowEditor()

VB.NET

Public Overrides Sub ShowEditor

Remarks

The method is called automatically when users invoke a cell editor. You can also call this method manually. If you want to activate a particular cell’s editor, you need to focus the cell first. Use the ColumnView.FocusedRowHandle and ColumnView.FocusedColumn properties for this purpose.

Note: a cell editor cannot be activated in the following cases:

• the ColumnViewOptionsBehavior.Editable option is disabled;
• the focused column’s OptionsColumn.AllowEdit property is set to false;
• the ColumnView.ShowingEditor event handler cancels the cell editor’s activation.

Refer to the Modify and Validate Cell Values topic for additional information.

Note

Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the ShowEditor member must not be invoked for these Views. The ShowEditor member can only be used with Views that display real data within the Grid Control. Use the following methods to access these Views with which an end user interacts at runtime.

• GridControl.MainView - returns the top most View in a grid;
• GridControl.FocusedView - returns the focused View;
• GridControl.DefaultView - returns the currently maximized View;
• the sender parameter of View specific events;
• GridView.GetDetailView - returns a detail clone View for a specific master row.

The code sample below illustrates how to activate a cell editor for the “Product Price” column when when they press F12.

C#

gridView1.KeyDown += GridView1_KeyDown;

private void GridView1_KeyDown(object sender, KeyEventArgs e)
{
    if(e.KeyCode == Keys.F12)
    {
        GridView view = sender as GridView;
        view.FocusedColumn = view.Columns["productPrice"];
        view.ShowEditor();
        e.Handled = true;
    }
}

VB.NET

Private gridView1.KeyDown += AddressOf GridView1_KeyDown

Private Sub GridView1_KeyDown(ByVal sender As Object, ByVal e As KeyEventArgs)
    If e.KeyCode = Keys.F12 Then
        Dim view As GridView = TryCast(sender, GridView)
        view.FocusedColumn = view.Columns("productPrice")
        view.ShowEditor()
        e.Handled = True
    End If
End Sub