TreeNodeCollection.Insert TreeNodeCollection.Insert TreeNodeCollection.Insert TreeNodeCollection.Insert Method

Definition

Fügt ein Element in der Auflistung an einer angegebenen Position.Inserts an item in the collection at a specified location.

Überlädt

Insert(Int32, String, String, String, String) Insert(Int32, String, String, String, String) Insert(Int32, String, String, String, String) Insert(Int32, String, String, String, String)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bildern und fügt es am angegebenen Index in die Auflistung ein.Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.

Insert(Int32, String, String, Int32, Int32) Insert(Int32, String, String, Int32, Int32) Insert(Int32, String, String, Int32, Int32) Insert(Int32, String, String, Int32, Int32)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bildern und fügt es am angegebenen Index in die Auflistung ein.Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.

Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bild und fügt es am angegebenen Index in die Auflistung ein.Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.

Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String)

Erstellt einen Strukturknoten mit dem angegebenen Text und den Schlüssel und fügt sie in der Auflistung ein.Creates a tree node with the specified text and key, and inserts it into the collection.

Insert(Int32, TreeNode) Insert(Int32, TreeNode) Insert(Int32, TreeNode) Insert(Int32, TreeNode)

Fügt einen vorhandenen Strukturknoten in der Auflistung der Strukturknoten an der angegebenen Position.Inserts an existing tree node into the tree node collection at the specified location.

Insert(Int32, String) Insert(Int32, String) Insert(Int32, String) Insert(Int32, String)

Erstellt einen Strukturknoten mit dem angegebenen Text und fügt es am angegebenen Index ein.Creates a tree node with the specified text and inserts it at the specified index.

Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bild und fügt es am angegebenen Index in die Auflistung ein.Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.

Insert(Int32, String, String, String, String) Insert(Int32, String, String, String, String) Insert(Int32, String, String, String, String) Insert(Int32, String, String, String, String)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bildern und fügt es am angegebenen Index in die Auflistung ein.Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey, System::String ^ selectedImageKey);
public virtual System.Windows.Forms.TreeNode Insert (int index, string key, string text, string imageKey, string selectedImageKey);
abstract member Insert : int * string * string * string * string -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string * string * string -> System.Windows.Forms.TreeNode
Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String, selectedImageKey As String) As TreeNode

Parameter

index
Int32 Int32 Int32 Int32

Die Position in der Auflistung den Knoten eingefügt werden soll.The location within the collection to insert the node.

key
String String String String

Der Name des Strukturknotens.The name of the tree node.

text
String String String String

Das im Strukturknoten anzuzeigende Text.The text to display in the tree node.

imageKey
String String String String

Der Schlüssel des Bildes, das im Strukturknoten angezeigt werden soll.The key of the image to display in the tree node.

selectedImageKey
String String String String

Der Schlüssel des Bildes, das im Strukturknoten angezeigt werden soll, wenn er ausgewählt wird.The key of the image to display in the tree node when it is in a selected state.

Gibt zurück

Die TreeNode , die in der Auflistung eingefügt wurde.The TreeNode that was inserted in the collection.

Hinweise

Wenn die Sorted -Eigenschaftensatz auf true, index Parameterwert wird ignoriert.If the Sorted property is set to true, the index parameter value is ignored. Die TreeNode wird in der Strukturansicht eingefügt und die TreeView neu sortiert wird.The TreeNode is inserted into the tree view and the TreeView is sorted again.

Sie können auch neue hinzufügen TreeNode -Objekte der Auflistung mithilfe der Add oder AddRange Methoden.You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in die TreeNodeCollection.The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

Die imageKey Parameter verweist auf ein Bild in der ImageList Eigenschaft des übergeordneten Elements TreeView.The imageKey parameter refers to an image in the ImageList property of the parent TreeView.

Die selectedimageKey Parameter verweist auf ein Bild in der StateImageList Eigenschaft des übergeordneten Elements TreeView.The selectedimageKey parameter refers to an image in the StateImageList property of the parent TreeView.

Insert(Int32, String, String, Int32, Int32) Insert(Int32, String, String, Int32, Int32) Insert(Int32, String, String, Int32, Int32) Insert(Int32, String, String, Int32, Int32)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bildern und fügt es am angegebenen Index in die Auflistung ein.Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex, int selectedImageIndex);
public virtual System.Windows.Forms.TreeNode Insert (int index, string key, string text, int imageIndex, int selectedImageIndex);
abstract member Insert : int * string * string * int * int -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string * int * int -> System.Windows.Forms.TreeNode
Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer, selectedImageIndex As Integer) As TreeNode

Parameter

index
Int32 Int32 Int32 Int32

Die Position in der Auflistung den Knoten eingefügt werden soll.The location within the collection to insert the node.

key
String String String String

Der Name des Strukturknotens.The name of the tree node.

text
String String String String

Das im Strukturknoten anzuzeigende Text.The text to display in the tree node.

imageIndex
Int32 Int32 Int32 Int32

Der Index des Bildes, das im Strukturknoten angezeigt werden soll.The index of the image to display in the tree node.

selectedImageIndex
Int32 Int32 Int32 Int32

Der Index des Bildes, das im Strukturknoten angezeigt werden soll, wenn er ausgewählt wird.The index of the image to display in the tree node when it is in a selected state.

Gibt zurück

Die TreeNode , die in der Auflistung eingefügt wurde.The TreeNode that was inserted in the collection.

Hinweise

Wenn die Sorted -Eigenschaftensatz auf true, index Parameterwert wird ignoriert.If the Sorted property is set to true, the index parameter value is ignored. Die TreeNode wird in der Strukturansicht eingefügt und die TreeView neu sortiert wird.The TreeNode is inserted into the tree view and the TreeView is sorted again.

Sie können auch neue hinzufügen TreeNode -Objekte der Auflistung mithilfe der Add oder AddRange Methoden.You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in die TreeNodeCollection.The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

Die imageIndex Parameter verweist auf ein Bild in der ImageList Eigenschaft des übergeordneten Elements TreeView.The imageIndex parameter refers to an image in the ImageList property of the parent TreeView.

Die selectedimageIndex Parameter verweist auf ein Bild in der StateImageList Eigenschaft des übergeordneten Elements TreeView.The selectedimageIndex parameter refers to an image in the StateImageList property of the parent TreeView.

Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bild und fügt es am angegebenen Index in die Auflistung ein.Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey);
public virtual System.Windows.Forms.TreeNode Insert (int index, string key, string text, string imageKey);
abstract member Insert : int * string * string * string -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string * string -> System.Windows.Forms.TreeNode
Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As TreeNode

Parameter

index
Int32 Int32 Int32 Int32

Die Position in der Auflistung den Knoten eingefügt werden soll.The location within the collection to insert the node.

key
String String String String

Der Name des Strukturknotens.The name of the tree node.

text
String String String String

Das im Strukturknoten anzuzeigende Text.The text to display in the tree node.

imageKey
String String String String

Der Schlüssel des Bildes, das im Strukturknoten angezeigt werden soll.The key of the image to display in the tree node.

Gibt zurück

Die TreeNode , die in der Auflistung eingefügt wurde.The TreeNode that was inserted in the collection.

Hinweise

Wenn die Sorted -Eigenschaftensatz auf true, index Parameterwert wird ignoriert.If the Sorted property is set to true, the index parameter value is ignored. Die TreeNode wird in der Strukturansicht eingefügt und die TreeView neu sortiert wird.The TreeNode is inserted into the tree view and the TreeView is sorted again.

Sie können auch neue hinzufügen TreeNode -Objekte der Auflistung mithilfe der Add oder AddRange Methoden.You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in die TreeNodeCollection.The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

Die imageKey Parameter verweist auf ein Bild in der ImageList Eigenschaft des übergeordneten Elements TreeView.The imageKey parameter refers to an image in the ImageList property of the parent TreeView.

Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String)

Erstellt einen Strukturknoten mit dem angegebenen Text und den Schlüssel und fügt sie in der Auflistung ein.Creates a tree node with the specified text and key, and inserts it into the collection.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text);
public virtual System.Windows.Forms.TreeNode Insert (int index, string key, string text);
abstract member Insert : int * string * string -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string -> System.Windows.Forms.TreeNode
Public Overridable Function Insert (index As Integer, key As String, text As String) As TreeNode

Parameter

index
Int32 Int32 Int32 Int32

Die Position in der Auflistung den Knoten eingefügt werden soll.The location within the collection to insert the node.

key
String String String String

Der Name des Strukturknotens.The name of the tree node.

text
String String String String

Das im Strukturknoten anzuzeigende Text.The text to display in the tree node.

Gibt zurück

Die TreeNode , die in der Auflistung eingefügt wurde.The TreeNode that was inserted in the collection.

Hinweise

Wenn die Sorted -Eigenschaftensatz auf true, index Parameterwert wird ignoriert.If the Sorted property is set to true, the index parameter value is ignored. Die TreeNode wird in der Strukturansicht eingefügt und die TreeView neu sortiert wird.The TreeNode is inserted into the tree view and the TreeView is sorted again.

Sie können auch neue hinzufügen TreeNode -Objekte der Auflistung mithilfe der Add oder AddRange Methoden.You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in die TreeNodeCollection.The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

Insert(Int32, TreeNode) Insert(Int32, TreeNode) Insert(Int32, TreeNode) Insert(Int32, TreeNode)

Fügt einen vorhandenen Strukturknoten in der Auflistung der Strukturknoten an der angegebenen Position.Inserts an existing tree node into the tree node collection at the specified location.

public:
 virtual void Insert(int index, System::Windows::Forms::TreeNode ^ node);
public virtual void Insert (int index, System.Windows.Forms.TreeNode node);
abstract member Insert : int * System.Windows.Forms.TreeNode -> unit
override this.Insert : int * System.Windows.Forms.TreeNode -> unit
Public Overridable Sub Insert (index As Integer, node As TreeNode)

Parameter

index
Int32 Int32 Int32 Int32

Die indizierte Position in der Auflistung den Strukturknoten eingefügt werden soll.The indexed location within the collection to insert the tree node.

node
TreeNode TreeNode TreeNode TreeNode

Die in die Auflistung einzufügende TreeNode-Klasse.The TreeNode to insert into the collection.

Ausnahmen

Die node ist gegenwärtig in ein anderes TreeView.The node is currently assigned to another TreeView.

Beispiele

Im folgenden Codebeispiel wird entfernt den ausgewählten Strukturknoten von einem TreeView und fügt es in ein anderes hinzu, wenn beide Auflistungen Struktur nicht schreibgeschützt sind.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. Beim eine Button geklickt wird, der TreeNode durch dargestellt die TreeView.SelectedNode Eigenschaft wird von einem gelöscht TreeView mit der Remove Methode und die andere hinzugefügt TreeView mithilfe der Insert Methode.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. In diesem Beispiel benötigen Sie eine Form enthält zwei TreeView Steuerelemente und ein Button.This example requires that you have a Form that contains two TreeView controls and a Button. Die TreeView Steuerelemente heißen treeView1 und treeView2.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

Hinweise

Wenn die TreeView.Sorted -Eigenschaftensatz auf true, index Parameterwert wird ignoriert.If the TreeView.Sorted property is set to true, the index parameter value is ignored. Die TreeNode wird in der Strukturansicht eingefügt und die TreeView neu sortiert.The TreeNode is inserted into the tree view, and the TreeView resorted.

Sie können auch neue hinzufügen TreeNode -Objekte der Auflistung mithilfe der Add oder AddRange Methoden.You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

So entfernen Sie eine TreeNode , die Sie zuvor hinzugefügt haben, verwenden Sie die Remove, RemoveAt, oder Clear Methoden.To remove a TreeNode that you previously added, use the Remove, RemoveAt, or Clear methods.

Hinweis

Ein TreeNode zugewiesen werden können, auf nur eine TreeView Steuerelement zu einem Zeitpunkt.A TreeNode can be assigned to only one TreeView control at a time. Um die Strukturknoten, einem neuen Strukturansicht-Steuerelement hinzuzufügen, müssen Sie diesen entfernen aus der anderen Strukturansicht zunächst oder Klonen Sie es.To add the tree node to a new tree view control, you must remove it from the other tree view first or clone it.

Insert(Int32, String) Insert(Int32, String) Insert(Int32, String) Insert(Int32, String)

Erstellt einen Strukturknoten mit dem angegebenen Text und fügt es am angegebenen Index ein.Creates a tree node with the specified text and inserts it at the specified index.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ text);
public virtual System.Windows.Forms.TreeNode Insert (int index, string text);
abstract member Insert : int * string -> System.Windows.Forms.TreeNode
override this.Insert : int * string -> System.Windows.Forms.TreeNode
Public Overridable Function Insert (index As Integer, text As String) As TreeNode

Parameter

index
Int32 Int32 Int32 Int32

Die Position in der Auflistung den Knoten eingefügt werden soll.The location within the collection to insert the node.

text
String String String String

Das im Strukturknoten anzuzeigende Text.The text to display in the tree node.

Gibt zurück

Die TreeNode , die in der Auflistung eingefügt wurde.The TreeNode that was inserted in the collection.

Hinweise

Wenn die Sorted -Eigenschaftensatz auf true, index Parameterwert wird ignoriert.If the Sorted property is set to true, the index parameter value is ignored. Die TreeNode wird in der Strukturansicht eingefügt und die TreeView neu sortiert wird.The TreeNode is inserted into the tree view and the TreeView is sorted again.

Sie können auch neue hinzufügen TreeNode -Objekte der Auflistung mithilfe der Add oder AddRange Methoden.You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bild und fügt es am angegebenen Index in die Auflistung ein.Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex);
public virtual System.Windows.Forms.TreeNode Insert (int index, string key, string text, int imageIndex);
abstract member Insert : int * string * string * int -> System.Windows.Forms.TreeNode
override this.Insert : int * string * string * int -> System.Windows.Forms.TreeNode
Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As TreeNode

Parameter

index
Int32 Int32 Int32 Int32

Die Position in der Auflistung den Knoten eingefügt werden soll.The location within the collection to insert the node.

key
String String String String

Der Name des Strukturknotens.The name of the tree node.

text
String String String String

Das im Strukturknoten anzuzeigende Text.The text to display in the tree node.

imageIndex
Int32 Int32 Int32 Int32

Der Index des Bildes, das im Strukturknoten angezeigt werden soll.The index of the image to display in the tree node.

Gibt zurück

Die TreeNode , die in der Auflistung eingefügt wurde.The TreeNode that was inserted in the collection.

Hinweise

Wenn die Sorted -Eigenschaftensatz auf true, index Parameterwert wird ignoriert.If the Sorted property is set to true, the index parameter value is ignored. Die TreeNode wird in der Strukturansicht eingefügt und die TreeView neu sortiert wird.The TreeNode is inserted into the tree view and the TreeView is sorted again.

Sie können auch neue hinzufügen TreeNode -Objekte der Auflistung mithilfe der Add oder AddRange Methoden.You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in die TreeNodeCollection.The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

Die imageIndex Parameter verweist auf ein Bild in der ImageList Eigenschaft des übergeordneten Elements TreeView.The imageIndex parameter refers to an image in the ImageList property of the parent TreeView.

Gilt für: