Back to Devexpress

TreeViewControl.NodeCheckStateChanged Event

wpf-devexpress-dot-xpf-dot-grid-dot-treeviewcontrol-598f734f.md

latest2.6 KB
Original Source

TreeViewControl.NodeCheckStateChanged Event

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

Namespace : DevExpress.Xpf.Grid

Assembly : DevExpress.Xpf.Grid.v25.2.dll

NuGet Package : DevExpress.Wpf.Grid.Core

Declaration

csharp
public event TreeViewNodeEventHandler NodeCheckStateChanged
vb
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"
                     .../>
csharp
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
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:

MethodDescription
TreeViewControl.CheckAllNodesChecks all nodes.
TreeViewControl.UncheckAllNodesUnchecks all nodes.
TreeListNode.IsCheckedChecks/unchecks the node.

See Also

TreeViewControl Class

TreeViewControl Members

DevExpress.Xpf.Grid Namespace