TreeViewControl.NodeCheckStateChanged Event

Occurs when a node’s check box value is changed.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v24.1.dll

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public event TreeViewNodeEventHandler NodeCheckStateChanged

VB.NET

Public Event NodeCheckStateChanged As TreeViewNodeEventHandler

Event Data

The NodeCheckStateChanged event's data class is DevExpress.Xpf.Grid.TreeList.TreeViewNodeEventArgs.

Remarks

When a node’s check state is changed, the TreeViewControl raises the NodeCheckStateChanged event. Use the TreeListNode.IsChecked property to identify whether a node is checked:

XAML

<dxg:TreeViewControl ShowCheckboxes="True"
                     NodeCheckStateChanged="treeview_NodeCheckStateChanged"
                     .../>

C#

using DevExpress.Xpf.Grid;

void treeview_NodeCheckStateChanged(object sender, DevExpress.Xpf.Grid.TreeList.TreeViewNodeEventArgs e){
    if (e.Node.IsChecked.Value && e.Node.HasChildren){
        foreach (TreeListNode node in e.Node.Nodes){
            node.IsChecked = false;
        }
    }
}

VB.NET

Imports DevExpress.Xpf.Grid

Private Sub treeview_NodeCheckStateChanged(ByVal sender As Object, ByVal e As DevExpress.Xpf.Grid.TreeList.TreeViewNodeEventArgs)
    If e.Node.IsChecked.Value AndAlso e.Node.HasChildren Then

        For Each node As TreeListNode In e.Node.Nodes
            node.IsChecked = False
        Next
    End If
End Sub

Use the following methods to check/uncheck nodes in code:

Method	Description
TreeViewControl.CheckAllNodes	Checks all nodes.
TreeViewControl.UncheckAllNodes	Unchecks all nodes.
TreeListNode.IsChecked	Checks/unchecks the node.