TreeNode.Nodes Property

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

[Visual Basic]
Public ReadOnly Property Nodes As TreeNodeCollection
[C#]
public TreeNodeCollection Nodes {get;}
[C++]
public: __property TreeNodeCollection* get_Nodes();
[JScript]
public function get Nodes() : TreeNodeCollection;

Property Value

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

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.

Example

[Visual Basic, C#, C++] The following 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 assumes you have two TreeView controls named treeView1 and treeView2, and a Button on a Form.

[Visual Basic] 
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 Not (treeView1.SelectedNode Is 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

[C#] 
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);
      }
   }
}

[C++] 
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 != 0) {
                TreeNode* tn = treeView1->SelectedNode;
                treeView1->Nodes->Remove(tn);
                treeView2->Nodes->Insert(treeView2->Nodes->Count, tn);
            }
        }
    }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

TreeNode Class | TreeNode Members | System.Windows.Forms Namespace | TreeNodeCollection | Nodes