TreeNodeCollection.Insert Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wstawia element w kolekcji w określonej lokalizacji.

Przeciążenia

Insert(Int32, String, String, String, String)	Tworzy węzeł drzewa z określonym kluczem, tekstem i obrazami i wstawia go do kolekcji w określonym indeksie.
Insert(Int32, String, String, Int32, Int32)	Tworzy węzeł drzewa z określonym kluczem, tekstem i obrazami i wstawia go do kolekcji w określonym indeksie.
Insert(Int32, String, String, String)	Tworzy węzeł drzewa z określonym kluczem, tekstem i obrazem i wstawia go do kolekcji w określonym indeksie.
Insert(Int32, String, String)	Tworzy węzeł drzewa z określonym tekstem i kluczem i wstawia go do kolekcji.
Insert(Int32, TreeNode)	Wstawia istniejący węzeł drzewa do kolekcji węzłów drzewa w określonej lokalizacji.
Insert(Int32, String)	Tworzy węzeł drzewa z określonym tekstem i wstawia go do określonego indeksu.
Insert(Int32, String, String, Int32)	Tworzy węzeł drzewa z określonym kluczem, tekstem i obrazem i wstawia go do kolekcji w określonym indeksie.

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

Tworzy węzeł drzewa z określonym kluczem, tekstem i obrazami i wstawia go do kolekcji w określonym indeksie.

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);

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

Parametry

index: Int32

Lokalizacja w kolekcji do wstawienia węzła.

key: String

Nazwa węzła drzewa.

text: String

Tekst do wyświetlenia w węźle drzewa.

imageKey: String

Klucz obrazu do wyświetlenia w węźle drzewa.

selectedImageKey: String

Klucz obrazu do wyświetlenia w węźle drzewa, gdy jest w wybranym stanie.

Zwraca

TreeNode

Element TreeNode , który został wstawiony w kolekcji.

Uwagi

Jeśli właściwość jest ustawiona Sorted na true, wartość parametru index jest ignorowana. Element TreeNode zostanie wstawiony do widoku drzewa i TreeView zostanie posortowany ponownie.

Możesz również dodać nowe TreeNode obiekty do kolekcji przy użyciu Add metod lub AddRange .

Właściwość Name odpowiada kluczowi elementu TreeNode w obiekcie TreeNodeCollection.

Parametr imageKey odwołuje się do obrazu we ImageList właściwości nadrzędnego TreeView.

Parametr selectedimageKey odwołuje się do obrazu we StateImageList właściwości nadrzędnego TreeView.

Dotyczy

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

Tworzy węzeł drzewa z określonym kluczem, tekstem i obrazami i wstawia go do kolekcji w określonym indeksie.

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);

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

Parametry

index: Int32

Lokalizacja w kolekcji do wstawienia węzła.

key: String

Nazwa węzła drzewa.

text: String

Tekst do wyświetlenia w węźle drzewa.

imageIndex: Int32

Indeks obrazu do wyświetlenia w węźle drzewa.

selectedImageIndex: Int32

Indeks obrazu do wyświetlenia w węźle drzewa, gdy jest w wybranym stanie.

Zwraca

TreeNode

Element TreeNode , który został wstawiony w kolekcji.

Uwagi

Jeśli właściwość jest ustawiona Sorted na true, wartość parametru index jest ignorowana. Element TreeNode zostanie wstawiony do widoku drzewa i TreeView zostanie posortowany ponownie.

Możesz również dodać nowe TreeNode obiekty do kolekcji przy użyciu Add metod lub AddRange .

Właściwość Name odpowiada kluczowi elementu TreeNode w obiekcie TreeNodeCollection.

Parametr imageIndex odwołuje się do obrazu we ImageList właściwości nadrzędnego TreeView.

Parametr selectedimageIndex odwołuje się do obrazu we StateImageList właściwości nadrzędnego TreeView.

Dotyczy

Insert(Int32, String, String, String)

Tworzy węzeł drzewa z określonym kluczem, tekstem i obrazem i wstawia go do kolekcji w określonym indeksie.

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);

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

Parametry

index: Int32

Lokalizacja w kolekcji do wstawienia węzła.

key: String

Nazwa węzła drzewa.

text: String

Tekst do wyświetlenia w węźle drzewa.

imageKey: String

Klucz obrazu do wyświetlenia w węźle drzewa.

Zwraca

TreeNode

Element TreeNode , który został wstawiony w kolekcji.

Uwagi

Jeśli właściwość jest ustawiona Sorted na true, wartość parametru index jest ignorowana. Element TreeNode zostanie wstawiony do widoku drzewa i TreeView zostanie posortowany ponownie.

Możesz również dodać nowe TreeNode obiekty do kolekcji przy użyciu Add metod lub AddRange .

Właściwość Name odpowiada kluczowi elementu TreeNode w obiekcie TreeNodeCollection.

Parametr imageKey odwołuje się do obrazu we ImageList właściwości nadrzędnego TreeView.

Dotyczy

Insert(Int32, String, String)

Tworzy węzeł drzewa z określonym tekstem i kluczem i wstawia go do kolekcji.

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);

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

Parametry

index: Int32

Lokalizacja w kolekcji do wstawienia węzła.

key: String

Nazwa węzła drzewa.

text: String

Tekst do wyświetlenia w węźle drzewa.

Zwraca

TreeNode

Element TreeNode , który został wstawiony w kolekcji.

Uwagi

Jeśli właściwość jest ustawiona Sorted na true, wartość parametru index jest ignorowana. Element TreeNode zostanie wstawiony do widoku drzewa i TreeView zostanie posortowany ponownie.

Możesz również dodać nowe TreeNode obiekty do kolekcji przy użyciu Add metod lub AddRange .

Właściwość Name odpowiada kluczowi elementu TreeNode w obiekcie TreeNodeCollection.

Dotyczy

Insert(Int32, TreeNode)

Wstawia istniejący węzeł drzewa do kolekcji węzłów drzewa w określonej lokalizacji.

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)

Parametry

index: Int32

Indeksowana lokalizacja w kolekcji w celu wstawienia węzła drzewa.

node: TreeNode

Element TreeNode do wstawienia do kolekcji.

Wyjątki

ArgumentException

Element node jest obecnie przypisany do innego TreeViewelementu .

Przykłady

Poniższy przykład kodu usuwa wybrany węzeł drzewa z jednego TreeView i dodaje go do innego, jeśli obie kolekcje węzłów drzewa nie są tylko do odczytu. Button Po kliknięciu TreeView.SelectedNode TreeNode elementu element reprezentowany przez właściwość zostanie usunięty z jednej TreeView przy użyciu metody i dodany do drugiego TreeView Insert przy Remove użyciu metody . W tym przykładzie wymagane jest posiadanie kontrolki Form zawierającej dwie TreeView kontrolki i .Button Kontrolki TreeView powinny mieć nazwę treeView1 i 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

Uwagi

Jeśli właściwość jest ustawiona TreeView.Sorted na true, wartość parametru index jest ignorowana. Obiekt TreeNode jest wstawiany do widoku drzewa i TreeView uciekany.

Możesz również dodać nowe TreeNode obiekty do kolekcji przy użyciu Add metod lub AddRange .

Aby usunąć TreeNode wcześniej dodany element, użyj Removemetod , RemoveAtlub Clear .

Uwaga

Do TreeNode jednej kontrolki można przypisać tylko jedną TreeView kontrolkę jednocześnie. Aby dodać węzeł drzewa do nowej kontrolki widoku drzewa, należy go najpierw usunąć z innego widoku drzewa lub sklonować.

Dotyczy

Insert(Int32, String)

Tworzy węzeł drzewa z określonym tekstem i wstawia go do określonego indeksu.

public:
 virtual System::Windows::Forms::TreeNode ^ Insert(int index, System::String ^ text);

public virtual System.Windows.Forms.TreeNode Insert (int index, 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

Parametry

index: Int32

Lokalizacja w kolekcji do wstawienia węzła.

text: String

Tekst do wyświetlenia w węźle drzewa.

Zwraca

TreeNode

Element TreeNode , który został wstawiony w kolekcji.

Uwagi

Jeśli właściwość jest ustawiona Sorted na true, wartość parametru index jest ignorowana. Element TreeNode zostanie wstawiony do widoku drzewa i TreeView zostanie posortowany ponownie.

Możesz również dodać nowe TreeNode obiekty do kolekcji przy użyciu Add metod lub AddRange .

Dotyczy

Insert(Int32, String, String, Int32)

Tworzy węzeł drzewa z określonym kluczem, tekstem i obrazem i wstawia go do kolekcji w określonym indeksie.

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);

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

Parametry

index: Int32

Lokalizacja w kolekcji do wstawienia węzła.

key: String

Nazwa węzła drzewa.

text: String

Tekst do wyświetlenia w węźle drzewa.

imageIndex: Int32

Indeks obrazu do wyświetlenia w węźle drzewa.

Zwraca

TreeNode

Element TreeNode , który został wstawiony w kolekcji.

Uwagi

Jeśli właściwość jest ustawiona Sorted na true, wartość parametru index jest ignorowana. Element TreeNode zostanie wstawiony do widoku drzewa i TreeView zostanie posortowany ponownie.

Możesz również dodać nowe TreeNode obiekty do kolekcji przy użyciu Add metod lub AddRange .

Właściwość Name odpowiada kluczowi elementu TreeNode w obiekcie TreeNodeCollection.

Parametr imageIndex odwołuje się do obrazu we ImageList właściwości nadrzędnego TreeView.

Dotyczy

TreeNodeCollection.Insert Metoda

Definicja

Przeciążenia

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

Parametry

Zwraca

Uwagi

Dotyczy

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

Parametry

Zwraca

Uwagi

Dotyczy

Insert(Int32, String, String, String)

Parametry

Zwraca

Uwagi

Dotyczy

Insert(Int32, String, String)

Parametry

Zwraca

Uwagi

Dotyczy

Insert(Int32, TreeNode)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Insert(Int32, String)

Parametry

Zwraca

Uwagi

Dotyczy

Insert(Int32, String, String, Int32)

Parametry

Zwraca

Uwagi

Dotyczy

Opinia

Dodatkowe zasoby