TreeNodeCollection::Item Property (Int32)

 

Gets or sets the TreeNode at the specified indexed location in the collection.

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

public:
property TreeNode^ default[
	int index
] {
	virtual TreeNode^ get(int index);
	virtual void set(int index, TreeNode^ value);
}

Parameters

index
Type: System::Int32

The indexed location of the TreeNode in the collection.

Property Value

Type: System.Windows.Forms::TreeNode^

The TreeNode at the specified indexed location in the collection.

Exception Condition
ArgumentOutOfRangeException

The index value is less than 0 or is greater than the number of tree nodes in the collection.

To assign TreeNode objects to a specific location, or to retrieve them from the TreeNodeCollection, you can reference the collection object with a specific index value. The index value of the TreeNodeCollection is a zero-based index.

The following code 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 requires that you have created a TreeView and a Button on a Form. The first TreeNode in your TreeView should have a text property of "Node0."

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[ 0 ]->Text->Equals( "Node0" ) )
   {
      this->treeView1->Nodes->RemoveAt( 0 );
   }
}

.NET Framework
Available since 1.1
Return to top
Show: