TreeList.ShowEditor() Method

Switches the TreeList control to edit mode.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v19.1.dll

Declaration

C#

public virtual void ShowEditor()

VB.NET

Public Overridable Sub ShowEditor

Remarks

Use the ShowEditor method to activate the current cell’s editor. An end-user can do the same by clicking a cell or pressing the ENTER or SPACE key when the cell is focused. The ShowEditor method can be useful, for instance, if you want to switch the TreeList control to edit mode in response to other user actions.

A cell’s editor cannot be activated in the following cases:

• The TreeListOptionsBehavior.Editable option is disabled.
• The current column’s TreeListOptionsColumn.ReadOnly option is enabled. This option is accessible via the column’s TreeListColumn.OptionsColumn property.
• The TreeList.ShowingEditor event handler sets its Cancel parameter to true.

Use the TreeList.CanShowEditor property to determine whether the current cell’s editor can be activated. This property checks all conditions listed above, in order to return its value.

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#

implementing-context-menus-for-treelist-nodes-e847/CS/Form1.cs#L27

    treeList1.OptionsBehavior.Editable = !treeList1.OptionsBehavior.Editable;
    treeList1.ShowEditor();
}

how-to-add-a-horizontal-cells-merge-capability-to-an-xtratreelist-control-e2501/CS/TreeListCellMerging/MyTreeList.cs#L96

this.FocusedColumn = this.VisibleColumns[this.FocusedColumn.VisibleIndex - 1];
base.ShowEditor();
return;

how-to-print-a-treelist-that-supports-the-horizontal-cell-merging-capability-e4344/CS/TreeListCellMerging/MyTreeList.cs#L103

this.FocusedColumn = this.VisibleColumns[this.FocusedColumn.VisibleIndex - 1];
base.ShowEditor();
return;

how-to-create-custom-treelist-control-which-implements-a-web-style-comment-system-e3520/CS/TestMyTreeListForum/MyTreeList.cs#L199

    base.ShowEditor();
}

VB.NET

implementing-context-menus-for-treelist-nodes-e847/VB/Form1.vb#L29

    treeList1.OptionsBehavior.Editable = Not treeList1.OptionsBehavior.Editable
    treeList1.ShowEditor()
End Sub

how-to-add-a-horizontal-cells-merge-capability-to-an-xtratreelist-control-e2501/VB/TreeListCellMerging/MyTreeList.vb#L87

Me.FocusedColumn = Me.VisibleColumns(Me.FocusedColumn.VisibleIndex - 1)
MyBase.ShowEditor()
Return

how-to-print-a-treelist-that-supports-the-horizontal-cell-merging-capability-e4344/VB/TreeListCellMerging/MyTreeList.vb#L93

Me.FocusedColumn = Me.VisibleColumns(Me.FocusedColumn.VisibleIndex - 1)
MyBase.ShowEditor()
Return

how-to-create-custom-treelist-control-which-implements-a-web-style-comment-system-e3520/VB/TestMyTreeListForum/MyTreeList.vb#L181

    MyBase.ShowEditor()
End Sub