TreeListView.FetchSublevelChildrenOnExpand Property

Gets or sets whether the TreeListView fetches child nodes of sub-level nodes when you expand their parent node. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

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

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public bool FetchSublevelChildrenOnExpand { get; set; }

VB.NET

Public Property FetchSublevelChildrenOnExpand As Boolean

Property Value

Type	Default	Description
Boolean	true	true to fetch child nodes of sub-level nodes when you expand their parent node; otherwise, false.

Remarks

Note

A TreeListView with the Self-Referential data structure (TreeDerivationMode is set to Selfreference) ignores the FetchSublevelChildrenOnExpand property.

Read Tutorial: Expand and Collapse Nodes

The TreeListView in hierarchical binding mode fetches child nodes of sub-level nodes when you expand their parent node.

If the FetchSublevelChildrenOnExpand property is false, all the child nodes display expand buttons (even if they do not have children) after you expand their parent node. The expand button is hidden when you expand a sub-level node that does not contain child nodes:

Related API

HasChildNodesPath Property

Use the TreeListView.HasChildNodesPath property to make a node display an expand button only if this node has children:

View Example: Control Visibility of Expand Buttons when Sub-level Children are not Fetched

EnableDynamicLoading Property

The TreeListView in hierarchical binding mode creates child nodes dynamically when you expand their parent node.

Set the TreeListView.EnableDynamicLoading property to false to create all nodes at once when the tree is loading.

Note

If the TreeListView.EnableDynamicLoading is false, the TreeListView fetches child nodes of sub-level nodes despite the FetchSublevelChildrenOnExpand property.