TreeListView.TreeDerivationMode Property

Gets or sets the tree derivation mode. 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 TreeDerivationMode TreeDerivationMode { get; set; }

VB.NET

Public Property TreeDerivationMode As TreeDerivationMode

Property Value

Type	Description
TreeDerivationMode	A TreeDerivationMode enumeration value that specifies the tree derivation mode.

Available values:

Name	Description
Selfreference	Builds a tree from a self-referential data structure. To learn more, see Bind to Self-Referential Data Structure.
ChildNodesSelector	You should manually write code to specify where a data object’s child items come from by creating a selector class. To learn more, see Bind to Hierarchical Data Structure.
HierarchicalDataTemplate	Builds a tree using Hierarchical Data Templates. To learn more, see Hierarchical Data Templates.

Remarks

In data bound mode, the TreeListView can display information in a tree from either a self-referential (flat) or hierarchical data structure. For each type of a data structure, it provides the corresponding tree derivation mode(s), specified via the TreeDerivationMode property.

If the TreeDerivationMode property is set to TreeDerivationMode.HierarchicalDataTemplate, optimized mode is automatically disabled.

To learn more, see Binding to Hierarchical Data Overview.

Related GitHub Examples

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

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.

XAML

wpf-lookupedit-display-treelist-as-popup-content/CS/CustomTreeViewComboBox/MainWindow.xaml#L21

                      ParentFieldName="ParentID"
                      TreeDerivationMode="Selfreference"/>
</dxg:GridControl.View>

how-to-emulate-binding-to-the-isexpanded-property-of-the-treelistnode-t127638/CS/DevExpress.Example04/MainWindow.xaml#L30

<dxg:GridControl.View>
    <dxg:TreeListView AllowPerPixelScrolling="True" ShowTotalSummary="True" TreeDerivationMode="HierarchicalDataTemplate"/>
</dxg:GridControl.View>

wpf-dashboard-how-to-embed-devexpress-control/CS/GanttSample/Window.xaml#L23

AutoExpandAllNodes="True"
TreeDerivationMode="Selfreference"
KeyFieldName="Id"

wpf-spreadsheet-chart-api/CS/SpreadsheetWPFChartAPISamples/MainWindow.xaml#L52

<dxg:TreeListControl.View>
    <dxg:TreeListView x:Name="view" TreeDerivationMode="ChildNodesSelector" ChildNodesSelector="{StaticResource childrenSelector}" ShowIndicator="False" ShowColumnHeaders="False" AutoWidth="True" AllowPerPixelScrolling="False" CustomColumnDisplayText="view_CustomColumnDisplayText" />
</dxg:TreeListControl.View>

wpf-spreadsheet-pivot-table-api-examples/CS/SpreadsheetWPFPivotTableExamples/MainWindow.xaml#L52

<dxg:TreeListControl.View>
    <dxg:TreeListView x:Name="view" TreeDerivationMode="ChildNodesSelector" ChildNodesSelector="{StaticResource childrenSelector}" ShowIndicator="False" ShowColumnHeaders="False" AutoWidth="True" AllowPerPixelScrolling="False" CustomColumnDisplayText="view_CustomColumnDisplayText" />
</dxg:TreeListControl.View>