CardView.ShowEditor() Method

Invokes the focused cell’s editor.

Namespace: DevExpress.XtraGrid.Views.Card

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 click a cell or press the ENTER or SPACE key when a cell is focused. You can call this method manually to facilitate user input. For instance, you may want to switch the View to edit mode at application startup. Another example can be implementing custom cell editing order with respect to data entered by end-users. Note that you will need to focus the desired cell before calling the ShowEditor method. Use the ColumnView.FocusedColumn and ColumnView.FocusedRowHandle properties for this purpose.

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

• The ColumnViewOptionsBehavior.Editable option is disabled. This option can be accessed via the View’s CardView.OptionsBehavior property.
• The owning column’s OptionsColumn.AllowEdit property is set to false. This option can be accessed via the column’s GridColumn.OptionsColumn property.
• The ColumnView.ShowingEditor event handler prohibits you from invoking the editor.

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 snippet (auto-collected from DevExpress Examples) contains a reference 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-add-a-new-record-to-a-card-view-e717/CS/WindowsApplication1/Form1.cs#L30

Cards.FocusedColumn = Cards.GetVisibleColumn(0);
Cards.ShowEditor();
e.Handled = true;

VB.NET

how-to-add-a-new-record-to-a-card-view-e717/VB/WindowsApplication1/Form1.vb#L26

Cards.FocusedColumn = Cards.GetVisibleColumn(0)
Cards.ShowEditor()
e.Handled = True