TreeNodeCollection.Remove(TreeNode) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Removes the specified tree node from the tree node collection.
public:
void Remove(System::Windows::Forms::TreeNode ^ node);
public void Remove (System.Windows.Forms.TreeNode node);
member this.Remove : System.Windows.Forms.TreeNode -> unit
Public Sub Remove (node As TreeNode)
Parameters
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 TreeNode represented by the TreeView.SelectedNode property 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 a Form that contains two TreeView controls and a Button. The TreeView controls should be named treeView1
and treeView2
.
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
When a TreeNode is removed from the tree node collection, all subsequent tree nodes are moved up one position in the collection.
You can also remove a TreeNode that you previously added by using the RemoveAt or Clear methods.
Note
Enumerating the collection and removing nodes is not supported.
To add new TreeNode objects to the collection, use the Add, AddRange, or Insert methods.