Udostępnij za pośrednictwem


TreeNodeCollection.Insert Metoda

Definicja

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

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

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

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

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

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.SelectedNodeTreeNode elementu element reprezentowany przez właściwość zostanie usunięty z jednej TreeView przy użyciu metody i dodany do drugiego TreeViewInsert 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

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

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