TreeNode.Nodes Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gets the collection of TreeNode objects assigned to the current tree node.

public:
 property System::Windows::Forms::TreeNodeCollection ^ Nodes { System::Windows::Forms::TreeNodeCollection ^ get(); };

[System.ComponentModel.ListBindable(false)]
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.TreeNodeCollection Nodes { get; }

[<System.ComponentModel.ListBindable(false)>]
[<System.ComponentModel.Browsable(false)>]
member this.Nodes : System.Windows.Forms.TreeNodeCollection

Public ReadOnly Property Nodes As TreeNodeCollection

Property Value

TreeNodeCollection

A TreeNodeCollection that represents the tree nodes assigned to the current tree node.

Attributes

ListBindableAttribute BrowsableAttribute

Examples

The following code example removes the selected tree node from one TreeView and adds it to another if both tree node collections are not read-only. When a Button is clicked, the TreeView.SelectedNode is deleted from one TreeView using the Remove method and added to the other TreeView using the Insert method. This example requires that you have two TreeView controls named treeView1 and treeView2, and a Button on a Form.

void button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // If neither TreeNodeCollection is read-only, move the
   // selected node from treeView1 to treeView2.
   if (  !treeView1->Nodes->IsReadOnly &&  !treeView2->Nodes->IsReadOnly )
   {
      if ( treeView1->SelectedNode != nullptr )
      {
         TreeNode^ tn = treeView1->SelectedNode;
         treeView1->Nodes->Remove( tn );
         treeView2->Nodes->Insert( treeView2->Nodes->Count, tn );
      }
   }
}

private void button1_Click(object sender, EventArgs e)
{
   // If neither TreeNodeCollection is read-only, move the 
   // selected node from treeView1 to treeView2.
   if(!treeView1.Nodes.IsReadOnly && !treeView2.Nodes.IsReadOnly)
   {
      if(treeView1.SelectedNode != null)
      {
         TreeNode tn = treeView1.SelectedNode;
         treeView1.Nodes.Remove(tn);
         treeView2.Nodes.Insert(treeView2.Nodes.Count, tn);
      }
   }
}

Private Sub button1_Click(sender As Object, e As EventArgs) Handles button1.Click
   ' If neither TreeNodeCollection is read-only, move the 
   ' selected node from treeView1 to treeView2. 
   If Not treeView1.Nodes.IsReadOnly And Not treeView2.Nodes.IsReadOnly Then
      If (treeView1.SelectedNode IsNot Nothing) Then
         Dim tn As TreeNode = treeView1.SelectedNode
         treeView1.Nodes.Remove(tn)
         treeView2.Nodes.Insert(treeView2.Nodes.Count, tn)
      End If
   End If
End Sub

Remarks

The Nodes property can hold a collection of other TreeNode objects. Each of the tree node in the collection has a Nodes property that can contain its own TreeNodeCollection. This nesting of tree nodes can make it difficult to navigate a tree structure. The FullPath property makes it easier to determine your location in a tree.

See also

• TreeNodeCollection
• Nodes