TreeNodeCollection.Insert Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fügt ein Element in die Auflistung an einer angegebenen Position ein.

Überlädt

Name	Beschreibung
Insert(Int32, String, String, String, String)	Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bildern und fügt ihn in die Auflistung am angegebenen Index ein.
Insert(Int32, String, String, Int32, Int32)	Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bildern und fügt ihn in die Auflistung am angegebenen Index ein.
Insert(Int32, String, String, String)	Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bild und fügt ihn in die Auflistung am angegebenen Index ein.
Insert(Int32, String, String)	Erstellt einen Strukturknoten mit dem angegebenen Text und schlüssel und fügt ihn in die Auflistung ein.
Insert(Int32, TreeNode)	Fügt an der angegebenen Position einen vorhandenen Strukturknoten in die Strukturknotenauflistung ein.
Insert(Int32, String)	Erstellt einen Strukturknoten mit dem angegebenen Text und fügt ihn am angegebenen Index ein.
Insert(Int32, String, String, Int32)	Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bild und fügt ihn in die Auflistung am angegebenen Index ein.

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

Quelle:

TreeNodeCollection.cs

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bildern und fügt ihn in die Auflistung am angegebenen Index ein.

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

Die Position innerhalb der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der text, der im Strukturknoten angezeigt werden soll.

imageKey

String

Der Schlüssel des Bilds, das im Strukturknoten angezeigt werden soll.

selectedImageKey

String

Der Schlüssel des Bilds, das im Strukturknoten angezeigt werden soll, wenn es sich in einem ausgewählten Zustand befindet.

Gibt zurück

TreeNode

Das TreeNode in die Auflistung eingefügte.

Hinweise

Wenn die Sorted Eigenschaft auf true festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode Datei wird in die Strukturansicht eingefügt und wird TreeView erneut sortiert.

Sie können der Auflistung auch neue TreeNode Objekte hinzufügen, indem Sie die Add Methoden verwenden AddRange .

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in der TreeNodeCollection.

Der imageKey Parameter bezieht sich auf ein Bild in der ImageList Eigenschaft des übergeordneten Elements TreeView.

Der selectedimageKey Parameter bezieht sich auf ein Bild in der StateImageList Eigenschaft des übergeordneten Elements TreeView.

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

Quelle:

TreeNodeCollection.cs

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bildern und fügt ihn in die Auflistung am angegebenen Index ein.

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

Die Position innerhalb der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der text, der im Strukturknoten angezeigt werden soll.

imageIndex

Int32

Der Index des Bilds, das im Strukturknoten angezeigt werden soll.

selectedImageIndex

Int32

Der Index des Bilds, das im Strukturknoten angezeigt werden soll, wenn es sich in einem ausgewählten Zustand befindet.

Gibt zurück

TreeNode

Das TreeNode in die Auflistung eingefügte.

Hinweise

Wenn die Sorted Eigenschaft auf true festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode Datei wird in die Strukturansicht eingefügt und wird TreeView erneut sortiert.

Sie können der Auflistung auch neue TreeNode Objekte hinzufügen, indem Sie die Add Methoden verwenden AddRange .

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in der TreeNodeCollection.

Der imageIndex Parameter bezieht sich auf ein Bild in der ImageList Eigenschaft des übergeordneten Elements TreeView.

Der selectedimageIndex Parameter bezieht sich auf ein Bild in der StateImageList Eigenschaft des übergeordneten Elements TreeView.

Insert(Int32, String, String, String)

Quelle:

TreeNodeCollection.cs

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bild und fügt ihn in die Auflistung am angegebenen Index ein.

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

Die Position innerhalb der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der text, der im Strukturknoten angezeigt werden soll.

imageKey

String

Der Schlüssel des Bilds, das im Strukturknoten angezeigt werden soll.

Gibt zurück

TreeNode

Das TreeNode in die Auflistung eingefügte.

Hinweise

Wenn die Sorted Eigenschaft auf true festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode Datei wird in die Strukturansicht eingefügt und wird TreeView erneut sortiert.

Sie können der Auflistung auch neue TreeNode Objekte hinzufügen, indem Sie die Add Methoden verwenden AddRange .

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in der TreeNodeCollection.

Der imageKey Parameter bezieht sich auf ein Bild in der ImageList Eigenschaft des übergeordneten Elements TreeView.

Insert(Int32, String, String)

Quelle:

TreeNodeCollection.cs

Erstellt einen Strukturknoten mit dem angegebenen Text und schlüssel und fügt ihn in die Auflistung ein.

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

Die Position innerhalb der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der text, der im Strukturknoten angezeigt werden soll.

Gibt zurück

TreeNode

Das TreeNode in die Auflistung eingefügte.

Hinweise

Wenn die Sorted Eigenschaft auf true festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode Datei wird in die Strukturansicht eingefügt und wird TreeView erneut sortiert.

Sie können der Auflistung auch neue TreeNode Objekte hinzufügen, indem Sie die Add Methoden verwenden AddRange .

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in der TreeNodeCollection.

Insert(Int32, TreeNode)

Quelle:

TreeNodeCollection.cs

Fügt an der angegebenen Position einen vorhandenen Strukturknoten in die Strukturknotenauflistung ein.

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

Die indizierte Position innerhalb der Auflistung, um den Strukturknoten einzufügen.

node

TreeNode

The TreeNode to insert into the collection.

Ausnahmen

ArgumentException

Das node wird derzeit einem anderen TreeViewzugewiesen.

Beispiele

Im folgenden Codebeispiel wird der ausgewählte Strukturknoten aus einem entfernt und zu einem TreeView anderen hinzugefügt, wenn beide Strukturknotensammlungen nicht schreibgeschützt sind. Wenn auf einen Button Klick geklickt wird, wird die TreeNode durch die Eigenschaft dargestellte Eigenschaft mithilfe der TreeView.SelectedNodeRemove Methode aus einem TreeView gelöscht und der anderen TreeView mithilfe der Insert Methode hinzugefügt. Dieses Beispiel erfordert, dass Sie über ein Form Steuerelement verfügen, das zwei TreeView Steuerelemente und ein ButtonSteuerelement enthält. Die TreeView Steuerelemente sollten benannt treeView1 und 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 Eigenschaft auf true festgelegt ist, wird der index Parameterwert ignoriert. Das TreeNode wird in die Baumansicht und das TreeView Resort eingefügt.

Sie können der Auflistung auch neue TreeNode Objekte hinzufügen, indem Sie die Add Methoden verwenden AddRange .

Um ein zuvor hinzugefügtes Element TreeNode zu entfernen, verwenden Sie die RemoveMethoden oder RemoveAtClear Methoden.

Hinweis

A TreeNode kann jeweils nur einem TreeView Steuerelement zugewiesen werden. Um den Strukturknoten einem neuen Strukturansichtssteuerelement hinzuzufügen, müssen Sie ihn zuerst aus der anderen Strukturansicht entfernen oder es klonen.

Insert(Int32, String)

Quelle:

TreeNodeCollection.cs

Erstellt einen Strukturknoten mit dem angegebenen Text und fügt ihn am angegebenen Index ein.

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

Die Position innerhalb der Auflistung, an der der Knoten eingefügt werden soll.

text

String

Der text, der im Strukturknoten angezeigt werden soll.

Gibt zurück

TreeNode

Das TreeNode in die Auflistung eingefügte.

Hinweise

Wenn die Sorted Eigenschaft auf true festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode Datei wird in die Strukturansicht eingefügt und wird TreeView erneut sortiert.

Sie können der Auflistung auch neue TreeNode Objekte hinzufügen, indem Sie die Add Methoden verwenden AddRange .

Insert(Int32, String, String, Int32)

Quelle:

TreeNodeCollection.cs

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, Text und Bild und fügt ihn in die Auflistung am angegebenen Index ein.

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

Die Position innerhalb der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der text, der im Strukturknoten angezeigt werden soll.

imageIndex

Int32

Der Index des Bilds, das im Strukturknoten angezeigt werden soll.

Gibt zurück

TreeNode

Das TreeNode in die Auflistung eingefügte.

Hinweise

Wenn die Sorted Eigenschaft auf true festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode Datei wird in die Strukturansicht eingefügt und wird TreeView erneut sortiert.

Sie können der Auflistung auch neue TreeNode Objekte hinzufügen, indem Sie die Add Methoden verwenden AddRange .

Die Name Eigenschaft entspricht dem Schlüssel für eine TreeNode in der TreeNodeCollection.

Der imageIndex Parameter bezieht sich auf ein Bild in der ImageList Eigenschaft des übergeordneten Elements TreeView.