Sdílet prostřednictvím


TreeNodeCollection.Insert Metoda

Definice

Vloží položku do kolekce v zadaném umístění.

Přetížení

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

Vytvoří stromový uzel se zadaným klíčem, textem a obrázky a vloží ho do kolekce v zadaném indexu.

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

Vytvoří stromový uzel se zadaným klíčem, textem a obrázky a vloží ho do kolekce v zadaném indexu.

Insert(Int32, String, String, String)

Vytvoří uzel stromové struktury se zadaným klíčem, textem a obrázkem a vloží ho do kolekce v zadaném indexu.

Insert(Int32, String, String)

Vytvoří uzel stromové struktury se zadaným textem a klíčem a vloží ho do kolekce.

Insert(Int32, TreeNode)

Vloží existující uzel stromové struktury do kolekce uzlů stromové struktury v zadaném umístění.

Insert(Int32, String)

Vytvoří stromový uzel se zadaným textem a vloží ho do zadaného indexu.

Insert(Int32, String, String, Int32)

Vytvoří uzel stromové struktury se zadaným klíčem, textem a obrázkem a vloží ho do kolekce v zadaném indexu.

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

Vytvoří stromový uzel se zadaným klíčem, textem a obrázky a vloží ho do kolekce v zadaném indexu.

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

Umístění v kolekci pro vložení uzlu

key
String

Název uzlu stromové struktury.

text
String

Text, který se má zobrazit ve stromovém uzlu.

imageKey
String

Klíč obrázku, který se má zobrazit ve stromovém uzlu.

selectedImageKey
String

Klíč obrázku, který se má zobrazit ve stromovém uzlu, když je ve vybraném stavu.

Návraty

Hodnota TreeNode , která byla vložena do kolekce.

Poznámky

Sorted Pokud je vlastnost nastavená na true, hodnota parametru index se ignoruje. Vloží TreeNode se do stromového zobrazení a TreeView seřadí se znovu.

Nové objekty můžete do kolekce přidat TreeNode také pomocí Add metod nebo AddRange .

Vlastnost Name odpovídá klíči pro objekt TreeNode v objektu TreeNodeCollection.

Parametr imageKey odkazuje na obrázek ve ImageList vlastnosti nadřazeného TreeViewobjektu .

Parametr selectedimageKey odkazuje na obrázek ve StateImageList vlastnosti nadřazeného TreeViewobjektu .

Platí pro

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

Vytvoří stromový uzel se zadaným klíčem, textem a obrázky a vloží ho do kolekce v zadaném indexu.

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

Umístění v kolekci pro vložení uzlu

key
String

Název uzlu stromové struktury.

text
String

Text, který se má zobrazit ve stromovém uzlu.

imageIndex
Int32

Index obrázku, který se má zobrazit ve stromovém uzlu.

selectedImageIndex
Int32

Index obrázku, který se má zobrazit ve stromovém uzlu, když je ve vybraném stavu.

Návraty

Hodnota TreeNode , která byla vložena do kolekce.

Poznámky

Sorted Pokud je vlastnost nastavená na true, hodnota parametru index se ignoruje. Vloží TreeNode se do stromového zobrazení a TreeView seřadí se znovu.

Nové objekty můžete do kolekce přidat TreeNode také pomocí Add metod nebo AddRange .

Vlastnost Name odpovídá klíči pro objekt TreeNode v objektu TreeNodeCollection.

Parametr imageIndex odkazuje na obrázek ve ImageList vlastnosti nadřazeného TreeViewobjektu .

Parametr selectedimageIndex odkazuje na obrázek ve StateImageList vlastnosti nadřazeného TreeViewobjektu .

Platí pro

Insert(Int32, String, String, String)

Vytvoří uzel stromové struktury se zadaným klíčem, textem a obrázkem a vloží ho do kolekce v zadaném indexu.

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

Umístění v kolekci pro vložení uzlu

key
String

Název uzlu stromové struktury.

text
String

Text, který se má zobrazit ve stromovém uzlu.

imageKey
String

Klíč obrázku, který se má zobrazit ve stromovém uzlu.

Návraty

Hodnota TreeNode , která byla vložena do kolekce.

Poznámky

Sorted Pokud je vlastnost nastavená na true, hodnota parametru index se ignoruje. Vloží TreeNode se do stromového zobrazení a TreeView seřadí se znovu.

Nové objekty můžete do kolekce přidat TreeNode také pomocí Add metod nebo AddRange .

Vlastnost Name odpovídá klíči pro objekt TreeNode v objektu TreeNodeCollection.

Parametr imageKey odkazuje na obrázek ve ImageList vlastnosti nadřazeného TreeViewobjektu .

Platí pro

Insert(Int32, String, String)

Vytvoří uzel stromové struktury se zadaným textem a klíčem a vloží ho do kolekce.

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

Umístění v kolekci pro vložení uzlu

key
String

Název uzlu stromové struktury.

text
String

Text, který se má zobrazit ve stromovém uzlu.

Návraty

Hodnota TreeNode , která byla vložena do kolekce.

Poznámky

Sorted Pokud je vlastnost nastavená na true, hodnota parametru index se ignoruje. Vloží TreeNode se do stromového zobrazení a TreeView seřadí se znovu.

Nové objekty můžete do kolekce přidat TreeNode také pomocí Add metod nebo AddRange .

Vlastnost Name odpovídá klíči pro objekt TreeNode v objektu TreeNodeCollection.

Platí pro

Insert(Int32, TreeNode)

Vloží existující uzel stromové struktury do kolekce uzlů stromové struktury v zadaném umístění.

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

Indexované umístění v kolekci pro vložení uzlu stromové struktury

node
TreeNode

Vloží TreeNode se do kolekce.

Výjimky

Objekt node je aktuálně přiřazen k jinému TreeViewobjektu .

Příklady

Následující příklad kódu odebere vybraný uzel stromu z jednoho TreeView a přidá ho do jiného, pokud obě kolekce uzlů stromové struktury nejsou jen pro čtení. Button Po kliknutí na TreeNode vlastnost reprezentovaná TreeView.SelectedNode vlastností je odstraněna z jednoho TreeView pomocí Remove metody a přidána do druhého TreeView pomocí Insert metody. Tento příklad vyžaduje, abyste měli Form objekt, který obsahuje dva TreeView ovládací prvky a .Button Ovládací TreeView prvky by měly mít název treeView1 a 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

Poznámky

TreeView.Sorted Pokud je vlastnost nastavená na true, hodnota parametru index se ignoruje. Vloží TreeNode se do stromového zobrazení a uchylí TreeView se.

Nové objekty můžete do kolekce přidat TreeNode také pomocí Add metod nebo AddRange .

Pokud chcete odebrat dříve přidaný TreeNode objekt, použijte Removemetody , RemoveAtnebo Clear .

Poznámka

A TreeNode lze přiřadit pouze k jednomu TreeView ovládacímu prvku najednou. Chcete-li přidat uzel stromové struktury do nového ovládacího prvku stromového zobrazení, musíte ho nejprve odebrat z druhého stromového zobrazení nebo ho naklonovat.

Platí pro

Insert(Int32, String)

Vytvoří stromový uzel se zadaným textem a vloží ho do zadaného indexu.

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

Umístění v kolekci pro vložení uzlu

text
String

Text, který se má zobrazit ve stromovém uzlu.

Návraty

Hodnota TreeNode , která byla vložena do kolekce.

Poznámky

Sorted Pokud je vlastnost nastavená na true, hodnota parametru index se ignoruje. Vloží TreeNode se do stromového zobrazení a TreeView seřadí se znovu.

Nové objekty můžete do kolekce přidat TreeNode také pomocí Add metod nebo AddRange .

Platí pro

Insert(Int32, String, String, Int32)

Vytvoří uzel stromové struktury se zadaným klíčem, textem a obrázkem a vloží ho do kolekce v zadaném indexu.

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

Umístění v kolekci pro vložení uzlu

key
String

Název uzlu stromové struktury.

text
String

Text, který se má zobrazit ve stromovém uzlu.

imageIndex
Int32

Index obrázku, který se má zobrazit ve stromovém uzlu.

Návraty

Hodnota TreeNode , která byla vložena do kolekce.

Poznámky

Sorted Pokud je vlastnost nastavená na true, hodnota parametru index se ignoruje. Vloží TreeNode se do stromového zobrazení a TreeView seřadí se znovu.

Nové objekty můžete do kolekce přidat TreeNode také pomocí Add metod nebo AddRange .

Vlastnost Name odpovídá klíči pro objekt TreeNode v objektu TreeNodeCollection.

Parametr imageIndex odkazuje na obrázek ve ImageList vlastnosti nadřazeného TreeViewobjektu .

Platí pro