CardView.ShowEditor() Method

Invokes the focused cell’s editor.

Namespace: DevExpress.XtraGrid.Views.Card

Assembly: DevExpress.XtraGrid.v24.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 (the user cannot edit the focused cell’s value) 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 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.