TreeListNode.Expanded Property

Gets or sets whether the node is expanded.

Namespace: DevExpress.XtraTreeList.Nodes

Assembly: DevExpress.XtraTreeList.v19.1.dll

Declaration

C#

[DefaultValue(false)]
[DXCategory("Behavior")]
public virtual bool Expanded { get; set; }

VB.NET

<DefaultValue(False)>
<DXCategory("Behavior")>
Public Overridable Property Expanded As Boolean

Property Value

Type	Default	Description
Boolean	**false**	true, if the node is expanded; otherwise, false.

Remarks

Set the Expanded property to true to display child nodes of the current node. If set to false, the current node collapses and all its child nodes are hidden.

C#

using DevExpress.XtraTreeList.Nodes;

TreeListNode node = treeList1.GetNodeByVisibleIndex(0);
node.Expanded = !node.Expanded;

VB.NET

Imports DevExpress.XtraTreeList.Nodes

TreeListNode node = treeList1.GetNodeByVisibleIndex(0)
node.Expanded = Not node.Expanded

If the TreeListNode.HasChildren property is set to false, setting the Expanded property to true does nothing. When the TreeListNode.HasChildren property is set to true, setting the TreeListNode.Expanded property to true causes the Tree List to fire the TreeList.BeforeExpand event. It allows the dynamic loading feature to be implemented in unbound mode.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Expanded 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.

C#

how-to-create-an-analog-of-gridlookupedit-with-treelist-in-a-popup-window-e4319/CS/RepositoryItemTreeListLookUpEdit.cs#L415

{
    if (node.ParentNode.Expanded == false)
    {

how-to-automatically-collapse-redundant-nodes-e2650/CS/AutoCollapseExample/Form1.cs#L24

public override void Execute(TreeListNode node) {
    if (!(node == fNode) && node.Expanded && !node.HasAsParent(fNode) && !fNode.HasAsParent(node))
        node.Expanded = false;

how-to-preserve-the-expanded-state-of-treelist-nodes-when-refreshing-data-e864/CS/TreeListViewState.cs#L47

    if(node != null)
        node.Expanded = true;
}

how-to-find-a-node-in-a-treelist-in-a-background-thread-e4531/CS/AsynchronousFindInTreeList/ExpandingToSpecificNode.cs#L32

if(idColumnValue == _idsToExpand[currentNodeIndexInList]) {
    node.Expanded = true;
    currentNodeIndexInList++;

how-to-copy-nodes-from-one-treelist-to-another-e3164/CS/CopyNodesExample/MainForm.cs#L50

    sourceTreeList.AppendNode(null, sourceTreeList.FocusedNode);
    sourceTreeList.FocusedNode.Expanded = true;
}

VB.NET

how-to-create-an-analog-of-gridlookupedit-with-treelist-in-a-popup-window-e4319/VB/RepositoryItemTreeListLookUpEdit.vb#L420

If node.ParentNode IsNot Nothing Then
    If node.ParentNode.Expanded = False Then
        ExpandNode(node.ParentNode, level)

how-to-automatically-collapse-redundant-nodes-e2650/VB/AutoCollapseExample/Form1.vb#L27

Public Overrides Sub Execute(ByVal node As TreeListNode)
    If Not(node Is fNode) AndAlso node.Expanded AndAlso (Not node.HasAsParent(fNode)) AndAlso (Not fNode.HasAsParent(node)) Then
        node.Expanded = False

how-to-find-a-node-in-a-treelist-in-a-background-thread-e4531/VB/AsynchronousFindInTreeList/ExpandingToSpecificNode.vb#L42

If idColumnValue = _idsToExpand(currentNodeIndexInList) Then
    node.Expanded = True
    currentNodeIndexInList += 1

how-to-copy-nodes-from-one-treelist-to-another-e3164/VB/CopyNodesExample/MainForm.vb#L55

    sourceTreeList.AppendNode(Nothing, sourceTreeList.FocusedNode)
    sourceTreeList.FocusedNode.Expanded = True
End Sub

how-to-load-an-image-in-a-treelist-cell-e896/VB/Form1.vb#L134

    node.Expanded = True
End Sub