Skip to main content
A newer version of this page is available. .

VGridControlBase.ShowEditor() Method

Invokes the focused cell’s editor.

Namespace: DevExpress.XtraVerticalGrid

Assembly: DevExpress.XtraVerticalGrid.v19.1.dll

Declaration

public void ShowEditor()

Remarks

The ShowEditor method is automatically called when end-users invoke a cell editor. You can also call this method manually. Note that if you want to activate a particular cell’s editor, you need to focus the cell first. Use the VGridControlBase.FocusedRow and VGridControlBase.FocusedRecord properties for this purpose.

A cell editor cannot be activated if the VGridControlBase.CanShowEditor property returns false.

For more information, see Showing and Hiding Editors.

Example

The following sample code assumes that a grid control has the row_Price editor row containing information about car prices. The code invokes the Price field editor of the first record when the form is loaded. When the editor is closed (here the code handles the VGridControlBase.HiddenEditor event), the next record is focused and the editor for the Price field is again invoked, etc.

private void Form1_Load(object sender, System.EventArgs e) {
    // some code concerning binding grid to data
    /....
    // invoking editor for the first data cell of the Price row
    vGridControl1.FocusedRecord = 0;
    vGridControl1.FocusedRow = vGridControl1.Rows["row_Price"];
    vGridControl1.ShowEditor();
}

private void vGridControl1_HiddenEditor(object sender, System.EventArgs e) {
    VGridControl vGrid = sender as VGridControl;
    // checking whether the Price row is focused
    if (vGrid.FocusedRow != vGrid.Rows["row_Price"]) return;
    if (vGrid.FocusedRecord == vGrid.RecordCount - 1) 
        vGrid.FocusedRecord = 0;
    else 
        vGrid.FocusedRecord++;
    // invoking editor for the currently focused data cell
    vGrid.ShowEditor();
}

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.

See Also