A newer version of this page is available. Switch to the current version.

TreeList.ShowingEditor Event

Fires before the TreeList is switched to edit mode.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v19.2.dll

Declaration

[DXCategory("Editor")]
public event CancelEventHandler ShowingEditor

Event Data

The ShowingEditor event's data class is CancelEventArgs. The following properties provide information specific to this event:

Property Description
Cancel Gets or sets a value indicating whether the event should be canceled.

Remarks

Write a ShowingEditor event handler to perform specific actions each time a cell editor is about to be displayed. It can be used to prohibit switching the TreeList control to edit mode. Set the Cancel parameter to true for this purpose.

Cells in the Tree List control are identified by a corresponding column and node. For the cell currently being processed, the column and node are identified by the TreeList.FocusedColumn and TreeList.FocusedNode properties respectively.

You can prohibit cell editing by disabling the TreeListOptionsBehavior.Editable option. Cells of a particular column can also be made read-only. Enable the desired column's TreeListColumn.ReadOnly option for this purpose. This option is available via the column's TreeListColumn.OptionsColumn property. Write a ShowingEditor event handler to prohibit cell editing within specific rows or make individual cells read-only.

NOTE

The ShowingEditor event does not fire for cells within the Auto Filter Row .

See Also