Export (0) Print
Expand All

TreeNodeCollection.RemoveAt Method

Removes a tree node from the tree node collection at a specified index.

[Visual Basic]
Public Overridable Sub RemoveAt( _
   ByVal index As Integer _
) Implements IList.RemoveAt
[C#]
public virtual void RemoveAt(
 int index
);
[C++]
public: virtual void RemoveAt(
 int index
);
[JScript]
public function RemoveAt(
   index : int
);

Parameters

index
The index of the TreeNode to remove.

Implements

IList.RemoveAt

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 Remove or Clear methods.

To add new TreeNode objects to the collection, use the Add, AddRange, or Insert methods.

Example

[Visual Basic, C#, C++] The following example removes the first TreeNode from a TreeView if its TreeNode.Text property is set to "Node0". When a Button is clicked, the first TreeNode in the TreeView is deleted using the RemoveAt method. This example assumes you have created a TreeView and a Button on a Form. The first TreeNode in your TreeView should have a text property of "Node0."

[Visual Basic] 
Private Sub button2_Click(sender As Object, e As EventArgs) Handles button2.Click
   ' Delete the first TreeNode in the collection 
   ' if the Text property is "Node0." 
   If Me.treeView1.Nodes(0).Text = "Node0" Then
      Me.treeView1.Nodes.RemoveAt(0)
   End If
End Sub

[C#] 
private void button2_Click(object sender, EventArgs e)
{
   // Delete the first TreeNode in the collection 
   // if the Text property is "Node0." 
   if(this.treeView1.Nodes[0].Text == "Node0")
   {
      this.treeView1.Nodes.RemoveAt(0);
   }
}

[C++] 
private:
    void button2_Click(Object* /*sender*/, EventArgs* /*e*/) {
        // Delete the first TreeNode in the collection
        // if the Text property is S"Node0."
        if (this->treeView1->Nodes->Item[0]->Text->Equals(S"Node0")) {
            this->treeView1->Nodes->RemoveAt(0);
        }
    }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter 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

TreeNodeCollection Class | TreeNodeCollection Members | System.Windows.Forms Namespace | Remove

Show:
© 2015 Microsoft