TreeNode.Collapse Method

Definition

Collapses the TreeNode.

Overloads

Collapse()

Collapses the tree node.

Collapse(Boolean)

Collapses the TreeNode and optionally collapses its children.

Collapse()

Source:
TreeNode.cs
Source:
TreeNode.cs
Source:
TreeNode.cs

Collapses the tree node.

C#
public void Collapse();

Examples

The following code example toggles the selected node when a button is clicked. If the selected node is collapsed, it is expanded, if it is expanded by calling the Expand method, it is collapsed by calling the Collapse method. This example requires that you have a Form with a TreeView control that has at least one TreeNode with at least one child TreeNode.

C#
private void button1_Click(object sender, System.EventArgs e)
{
   if (treeView1.SelectedNode.IsExpanded)
   {
      treeView1.SelectedNode.Collapse();
      MessageBox.Show(treeView1.SelectedNode.Text + 
        " tree node collapsed.");
   }
   else
   {
      treeView1.SelectedNode.Expand();
      MessageBox.Show(treeView1.SelectedNode.Text + 
        " tree node expanded.");
   }
}

Remarks

The Collapse method collapses the current TreeNode and its child nodes. If you want to collapse only the current TreeNode, use the TreeNode.Collapse(Boolean) overload, passing true to ignore its child nodes.

Note

The state of a TreeNode is persisted. For example, if the next level of child nodes was not collapsed previously, when the Expand method is called, the child nodes appear in their previously expanded state.

See also

Applies to

.NET Framework 4.8.1 and other versions
Product Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Collapse(Boolean)

Source:
TreeNode.cs
Source:
TreeNode.cs
Source:
TreeNode.cs

Collapses the TreeNode and optionally collapses its children.

C#
public void Collapse(bool ignoreChildren);

Parameters

ignoreChildren
Boolean

true to leave the child nodes in their current state; false to collapse the child nodes.

Remarks

Use the Collapse method, passing true, when you want to collapse a node but leave its child nodes in their expanded state.

Applies to

.NET Framework 4.8.1 and other versions
Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9