TreeListView.ChildNodesPath Property

Gets or sets the name of the ‘children’ field. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

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

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public string ChildNodesPath { get; set; }

VB.NET

Public Property ChildNodesPath As String

Property Value

Type	Description
String	A String value that specifies the ‘children’ field name.

Remarks

View Example: Implement the Child Nodes Path

Use the Child Nodes Path to bind the TreeListView to a collection if all objects have the same children field. An example of such a structure is shown below:

C#

public class BaseObject {
    public string Name { get; set; }
    public String Executor { get; set; }
    public ObservableCollection<Task> Tasks { get; set; }
}

public class ProjectObject : BaseObject {}

public class Task : BaseObject {
    public string State { get; set; }
}

VB.NET

Public Class BaseObject
    Public Property Name As String
    Public Property Executor As String
    Public Property Tasks As ObservableCollection(Of Task)
End Class

Public Class ProjectObject
    Inherits BaseObject
End Class

Public Class Task
    Inherits BaseObject

    Public Property State As String
End Class 

1. Set the ChildNodesPath property to the children field name.

2. Set the TreeListView.TreeDerivationMode property to ChildNodesSelector.

   In the code sample below, the Tasks field is the children field:

   XAML

   <dxg:TreeListControl Name="treeListView1" ItemsSource="{Binding DataItems}">
       <dxg:TreeListControl.Columns>
           <dxg:TreeListColumn FieldName="Name" AllowSorting="True" />
           <dxg:TreeListColumn FieldName="Executor" AllowSorting="True" />
           <dxg:TreeListColumn FieldName="State" AllowSorting="True" />
       </dxg:TreeListControl.Columns>
       <dxg:TreeListControl.View>
           <dxg:TreeListView TreeDerivationMode="ChildNodesSelector" ChildNodesPath="Tasks"/>
       </dxg:TreeListControl.View> 
   </dxg:TreeListControl>
   

Set the TreeListView.AllowChildNodeSourceUpdates property to true to update child nodes when you set the collection property to a new value.

Refer to the following help topic for more information: Bind to Hierarchical Data Structure.