TreeNodeCollection.Insert 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

在指定位置插入一個項目。

多載

名稱	Description
Insert(Int32, String, String, String, String)	建立一個樹狀節點，包含指定的鍵、文字和圖片，並將其插入指定的索引中。
Insert(Int32, String, String, Int32, Int32)	建立一個樹狀節點，包含指定的鍵、文字和圖片，並將其插入指定的索引中。
Insert(Int32, String, String, String)	建立一個樹狀節點，包含指定的鍵、文字和圖片，並將其插入指定的索引集合中。
Insert(Int32, String, String)	建立一個樹狀節點，包含指定的文字與鍵，並將其插入集合中。
Insert(Int32, TreeNode)	在指定位置將現有的樹節點插入樹節點集合中。
Insert(Int32, String)	建立一個樹狀節點，包含指定的文字，並在指定的索引處插入。
Insert(Int32, String, String, Int32)	建立一個樹狀節點，包含指定的鍵、文字和圖片，並將其插入指定的索引集合中。

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

來源:

TreeNodeCollection.cs

建立一個樹狀節點，包含指定的鍵、文字和圖片，並將其插入指定的索引中。

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

參數

index

Int32

集合中插入節點的位置。

key

String

樹節點的名稱。

text

String

文字要顯示在樹節點中。

imageKey

String

圖片的鍵要顯示在樹節點中。

selectedImageKey

String

當影像處於選擇狀態時，要在樹節點中顯示的鍵。

傳回

TreeNode

TreeNode那個入收藏的作品。

備註

若 Sorted 屬性設為 true， index 則忽略參數值。 TreeNode將 插入樹狀檢視，然後TreeView再次排序。

你也可以透過使用 Add or AddRange 方法新增TreeNode物件到集合中。

該Name性質對應於 中 a 的TreeNodeTreeNodeCollection鍵。

參數imageKey指的是父 屬性中的ImageListTreeView影像。

參數selectedimageKey指的是父 屬性中的StateImageListTreeView影像。

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

來源:

TreeNodeCollection.cs

建立一個樹狀節點，包含指定的鍵、文字和圖片，並將其插入指定的索引中。

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

參數

index

Int32

集合中插入節點的位置。

key

String

樹節點的名稱。

text

String

文字要顯示在樹節點中。

imageIndex

Int32

要在樹節點顯示的影像索引。

selectedImageIndex

Int32

當影像處於選取狀態時，要在樹節點中顯示的索引。

傳回

TreeNode

TreeNode那個入收藏的作品。

備註

若 Sorted 屬性設為 true， index 則忽略參數值。 TreeNode將 插入樹狀檢視，然後TreeView再次排序。

你也可以透過使用 Add or AddRange 方法新增TreeNode物件到集合中。

該Name性質對應於 中 a 的TreeNodeTreeNodeCollection鍵。

參數imageIndex指的是父 屬性中的ImageListTreeView影像。

參數selectedimageIndex指的是父 屬性中的StateImageListTreeView影像。

Insert(Int32, String, String, String)

來源:

TreeNodeCollection.cs

建立一個樹狀節點，包含指定的鍵、文字和圖片，並將其插入指定的索引集合中。

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

參數

index

Int32

集合中插入節點的位置。

key

String

樹節點的名稱。

text

String

文字要顯示在樹節點中。

imageKey

String

圖片的鍵要顯示在樹節點中。

傳回

TreeNode

TreeNode那個入收藏的作品。

備註

若 Sorted 屬性設為 true， index 則忽略參數值。 TreeNode將 插入樹狀檢視，然後TreeView再次排序。

你也可以透過使用 Add or AddRange 方法新增TreeNode物件到集合中。

該Name性質對應於 中 a 的TreeNodeTreeNodeCollection鍵。

參數imageKey指的是父 屬性中的ImageListTreeView影像。

Insert(Int32, String, String)

來源:

TreeNodeCollection.cs

建立一個樹狀節點，包含指定的文字與鍵，並將其插入集合中。

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

參數

index

Int32

集合中插入節點的位置。

key

String

樹節點的名稱。

text

String

文字要顯示在樹節點中。

傳回

TreeNode

TreeNode那個入收藏的作品。

備註

若 Sorted 屬性設為 true， index 則忽略參數值。 TreeNode將 插入樹狀檢視，然後TreeView再次排序。

你也可以透過使用 Add or AddRange 方法新增TreeNode物件到集合中。

該Name性質對應於 中 a 的TreeNodeTreeNodeCollection鍵。

Insert(Int32, TreeNode)

來源:

TreeNodeCollection.cs

在指定位置將現有的樹節點插入樹節點集合中。

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)

參數

index

Int32

集合中插入樹節點的索引位置。

node

TreeNode

將 TreeNode 插入收藏。

例外狀況

ArgumentException

目前 該 node 被分配給另一個 TreeView。

範例

以下範例是將選取的樹節點從一個 TreeView 節點移除，若兩個樹節點集合都不是唯讀，則將其加入另一個。 當點擊 a Button 時，TreeNode該屬性所代表TreeView.SelectedNode的物件會用該Remove方法從其中一TreeView處刪除，並用該Insert方法加入另一TreeView方。 此範例要求你有一個 Form 包含兩個 TreeView 控制項且 一個 Button。 TreeView控制節點應命名treeView1為 和 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

備註

若 TreeView.Sorted 屬性設為 true， index 則忽略參數值。 它 TreeNode 入樹景，並 TreeView 被轉化。

你也可以透過使用 Add or AddRange 方法新增TreeNode物件到集合中。

要移除你之前新增的 ， TreeNode 請使用 Remove、 RemoveAt或 Clear 方法。

備註

A TreeNode 一次只能指派給一個 TreeView 控制點。 要將樹節點加入新的樹狀檢視控制項，必須先從另一個樹狀檢視中移除或複製它。

Insert(Int32, String)

來源:

TreeNodeCollection.cs

建立一個樹狀節點，包含指定的文字，並在指定的索引處插入。

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

參數

index

Int32

集合中插入節點的位置。

text

String

文字要顯示在樹節點中。

傳回

TreeNode

TreeNode那個入收藏的作品。

備註

若 Sorted 屬性設為 true， index 則忽略參數值。 TreeNode將 插入樹狀檢視，然後TreeView再次排序。

你也可以透過使用 Add or AddRange 方法新增TreeNode物件到集合中。

Insert(Int32, String, String, Int32)

來源:

TreeNodeCollection.cs

建立一個樹狀節點，包含指定的鍵、文字和圖片，並將其插入指定的索引集合中。

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

參數

index

Int32

集合中插入節點的位置。

key

String

樹節點的名稱。

text

String

文字要顯示在樹節點中。

imageIndex

Int32

要在樹節點顯示的影像索引。

傳回

TreeNode

TreeNode那個入收藏的作品。

備註

若 Sorted 屬性設為 true， index 則忽略參數值。 TreeNode將 插入樹狀檢視，然後TreeView再次排序。

你也可以透過使用 Add or AddRange 方法新增TreeNode物件到集合中。

該Name性質對應於 中 a 的TreeNodeTreeNodeCollection鍵。

參數imageIndex指的是父 屬性中的ImageListTreeView影像。