Nodes Property

TreeNode::Nodes Property


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

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

property TreeNodeCollection^ Nodes {
	TreeNodeCollection^ get();

Property Value

Type: System.Windows.Forms::TreeNodeCollection^

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

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.

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 );

.NET Framework
Available since 1.1
Return to top
© 2016 Microsoft