TreeNodeCollection.Insert Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

Überlädt

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

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

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, dem angegebenen Text und den angegebenen Bildern und fügt diesen am angegebenen Index in die Auflistung 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 in der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der im Strukturknoten anzuzeigende Text.

imageKey

String

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

selectedImageKey

String

Der Schlüssel des Bildes, das im Strukturknoten angezeigt werden soll, wenn dieser ausgewählt wird.

Gibt zurück

TreeNode

Der TreeNode, der in die Auflistung eingefügt wurde.

Hinweise

Wenn die Sorted Eigenschaft auf true"Festgelegt" festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode wird in die Strukturansicht eingefügt und die TreeView Wird 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 TreeViewElements.

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

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

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, dem angegebenen Text und den angegebenen Bildern und fügt diesen am angegebenen Index in die Auflistung 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 in der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der im Strukturknoten anzuzeigende Text.

imageIndex

Int32

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

selectedImageIndex

Int32

Der Index des Bildes, das im Strukturknoten angezeigt werden soll, wenn dieser ausgewählt wird.

Gibt zurück

TreeNode

Der TreeNode, der in die Auflistung eingefügt wurde.

Hinweise

Wenn die Sorted Eigenschaft auf true"Festgelegt" festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode wird in die Strukturansicht eingefügt und die TreeView Wird 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 TreeViewElements.

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

Insert(Int32, String, String, String)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, dem angegebenen Text und dem angegebenen Bild und fügt diesen am angegebenen Index in die Auflistung 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 in der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der im Strukturknoten anzuzeigende Text.

imageKey

String

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

Gibt zurück

TreeNode

Der TreeNode, der in die Auflistung eingefügt wurde.

Hinweise

Wenn die Sorted Eigenschaft auf true"Festgelegt" festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode wird in die Strukturansicht eingefügt und die TreeView Wird 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 TreeViewElements.

Insert(Int32, String, String)

Erstellt einen Strukturknoten mit dem angegebenen Text und dem angegebenen Schlüssel und fügt diesen 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 in der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der im Strukturknoten anzuzeigende Text.

Gibt zurück

TreeNode

Der TreeNode, der in die Auflistung eingefügt wurde.

Hinweise

Wenn die Sorted Eigenschaft auf true"Festgelegt" festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode wird in die Strukturansicht eingefügt und die TreeView Wird 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)

Fügt einen vorhandenen Strukturknoten an der angegebenen Position 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 in der Auflistung, an der der Strukturknoten eingefügt werden soll.

node

TreeNode

Die in die Auflistung einzufügende TreeNode-Klasse.

Ausnahmen

ArgumentException

Der node ist derzeit einer anderen TreeView zugewiesen.

Beispiele

Im folgenden Codebeispiel wird der ausgewählte Strukturknoten von einem entfernt und zu einem TreeView anderen hinzugefügt, wenn beide Strukturknotensammlungen nicht schreibgeschützt sind. Wenn ein Button Klick erfolgt, wird die TreeNode durch die Eigenschaft dargestellte Eigenschaft mithilfe der TreeView.SelectedNode Remove Methode gelöscht TreeView und der anderen TreeView mithilfe der Insert Methode hinzugefügt. In diesem Beispiel ist erforderlich, dass Sie über ein Form Steuerelement verfügen, das zwei TreeView Steuerelemente und ein Steuerelement Buttonenthä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" festgelegt ist, wird der index Parameterwert ignoriert. Dies TreeNode wird in die Strukturansicht eingefügt, und das TreeView resortierte.

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

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

Hinweis

Eine TreeNode kann jeweils nur einem TreeView Steuerelement zugewiesen werden. Zum Hinzufügen des Strukturknotens zu einem neuen Strukturansichtssteuerelement müssen Sie ihn zuerst aus der anderen Strukturansicht entfernen oder es klonen.

Insert(Int32, String)

Erstellt einen Strukturknoten mit dem angegebenen Text und fügt diesen 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 in der Auflistung, an der der Knoten eingefügt werden soll.

text

String

Der im Strukturknoten anzuzeigende Text.

Gibt zurück

TreeNode

Der TreeNode, der in die Auflistung eingefügt wurde.

Hinweise

Wenn die Sorted Eigenschaft auf true"Festgelegt" festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode wird in die Strukturansicht eingefügt und die TreeView Wird 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)

Erstellt einen Strukturknoten mit dem angegebenen Schlüssel, dem angegebenen Text und dem angegebenen Bild und fügt diesen am angegebenen Index in die Auflistung 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 in der Auflistung, an der der Knoten eingefügt werden soll.

key

String

Der Name des Strukturknotens.

text

String

Der im Strukturknoten anzuzeigende Text.

imageIndex

Int32

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

Gibt zurück

TreeNode

Der TreeNode, der in die Auflistung eingefügt wurde.

Hinweise

Wenn die Sorted Eigenschaft auf true"Festgelegt" festgelegt ist, wird der index Parameterwert ignoriert. Die TreeNode wird in die Strukturansicht eingefügt und die TreeView Wird 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 TreeViewElements.