TreeList.CellValueChanged Event

Fires immediately after a cell editor is closed if the editor’s value has been modified.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v18.1.dll

Declaration

C#

[DXCategory("Property Changed")]
public event CellValueChangedEventHandler CellValueChanged

VB.NET

<DXCategory("Property Changed")>
Public Event CellValueChanged As CellValueChangedEventHandler

Event Data

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

Property	Description
Column	Gets a column to which the cell processed by an event belongs. Inherited from CellEventArgs.
Node	Gets the current Tree List node. Inherited from NodeEventArgs.
Value	Gets the new value assigned to a cell.

Remarks

Cell values are modified by means of in-place editors. End-users can click a cell or press the ENTER, F2 or SPACE key when a cell is focused to invoke an in-place editor. Clicking outside the edited cell or pressing the ENTER key when a cell is being edited results in closing the editor. If the in-place editor’s value has been modified before closing the editor, the CellValueChanged event is raised. The event’s parameters allow you to identify the cell’s column and node and obtain the newly assigned value.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CellValueChanged event.

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#

XAF_treelisteditor-how-to-enable-in-place-editing-in-the-winforms-tree-list-view-xpo-e443/CS/WinSolution.Module.Win/TreeListInplaceEditViewController.cs#L33

private void SubscribeToControlEvents(TreeList treeList) {
    treeList.CellValueChanged += treeList_CellValueChanged;
    treeList.ShownEditor += treeList_ShownEditor;

how-to-use-datatable-with-master-detail-relationships-in-treelist-e3597/CS/E3597/UnboundMasterDetailTree.cs#L41

_masterTreeList.BeforeExpand += new BeforeExpandEventHandler(BeforeExpand);
_masterTreeList.CellValueChanged += new CellValueChangedEventHandler(_masterTreeList_CellValueChanged);
_dataSource = dt;

VB.NET

XAF_treelisteditor-how-to-enable-in-place-editing-in-the-winforms-tree-list-view-xpo-e443/VB/WinSolution.Module.Win/TreeListInplaceEditViewController.vb#L35

Private Sub SubscribeToControlEvents(ByVal treeList As TreeList)
    AddHandler treeList.CellValueChanged, AddressOf treeList_CellValueChanged
    AddHandler treeList.ShownEditor, AddressOf treeList_ShownEditor

how-to-add-a-checkbox-into-the-node-indicator-cells-e2821/VB/WindowsApplication29/Form1.vb#L119

Private Sub treeList1_CellValueChanged(ByVal sender As Object, ByVal e As CellValueChangedEventArgs) Handles treeList1.CellValueChanged
    If e.Column.FieldName = "Bool0" OrElse e.Column.FieldName = "Bool1" Then

how-to-use-datatable-with-master-detail-relationships-in-treelist-e3597/VB/E3597/UnboundMasterDetailTree.vb#L40

AddHandler _masterTreeList.BeforeExpand, AddressOf BeforeExpand
AddHandler _masterTreeList.CellValueChanged, AddressOf _masterTreeList_CellValueChanged
Dim rootNode As TreeListNode = Nothing