GridView.ShowEditor() Method

Invokes the focused cell’s editor.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

public override void ShowEditor()

VB.NET

Public Overrides Sub ShowEditor

Remarks

The method is called automatically when end-users invoke a cell editor. You can also call this method manually. Note that if you want to active 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 prohibits cell editing.

Please 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 real Views that are displayed within the Grid Control. The real Views with which an end-user interacts at runtime can be accessed using the following methods.

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

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ShowEditor() method.

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#

how-to-change-an-in-place-checkbox-state-by-single-click-when-multi-selection-is-enabled-e3478/CS/Form1.cs#L65

view.FocusedRowHandle = hi.RowHandle;
view.ShowEditor();
CheckEdit edit = view.ActiveEditor as CheckEdit;

how-to-activate-an-in-place-editor-in-the-grid-when-it-gets-focused-e808/CS/Form1.cs#L207

        view.FocusedRowHandle = GridControl.NewItemRowHandle;
    BeginInvoke(new MethodInvoker(delegate { view.ShowEditor(); }));
}

how-to-add-a-new-row-to-a-grid-by-typing-in-a-new-item-row-as-in-datagridview-e2891/CS/WindowsApplication3/Main.cs#L39

gridView.UpdateCurrentRow();
gridView.ShowEditor();
TextEdit edit = sender as TextEdit;

how-to-automatically-expand-the-detail-view-when-new-master-row-is-added-e1436/CS/Q205071/Form1.cs#L62

    gridControl1.FocusedView = childView;
    childView.ShowEditor();
}

how-to-change-a-checkboxs-state-using-a-single-mouse-click-in-multiselection-mode-e2166/CS/Form1.cs#L46

gridView1.FocusedRowHandle = hitInfo.RowHandle;
gridView1.ShowEditor();
CheckEdit edit = gridView1.ActiveEditor as CheckEdit;

VB.NET

how-to-change-an-in-place-checkbox-state-by-single-click-when-multi-selection-is-enabled-e3478/VB/Form1.vb#L61

view.FocusedRowHandle = hi.RowHandle
view.ShowEditor()
Dim edit As CheckEdit = TryCast(view.ActiveEditor, CheckEdit)

how-to-activate-an-in-place-editor-in-the-grid-when-it-gets-focused-e808/VB/Form1.vb#L188

Private Sub ShowEditor()
    view.ShowEditor()
End Sub

how-to-add-a-new-row-to-a-grid-by-typing-in-a-new-item-row-as-in-datagridview-e2891/VB/WindowsApplication3/Main.vb#L33

gridView.UpdateCurrentRow()
gridView.ShowEditor()
Dim edit As TextEdit = TryCast(sender, TextEdit)

how-to-automatically-expand-the-detail-view-when-new-master-row-is-added-e1436/VB/Q205071/Form1.vb#L69

    gridControl1.FocusedView = childView
    childView.ShowEditor()
End Sub

how-to-change-a-checkboxs-state-using-a-single-mouse-click-in-multiselection-mode-e2166/VB/Form1.vb#L42

gridView1.FocusedRowHandle = hitInfo.RowHandle
gridView1.ShowEditor()
Dim edit As CheckEdit = TryCast(gridView1.ActiveEditor, CheckEdit)