TreeNodeCollection.Insert 方法

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將項目插入至指定位置的集合中。

多載

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)

使用指定的索引鍵、文字和影像建立樹狀節點，並將它插入指定索引處的集合中。

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 或 AddRange 方法，將新 TreeNode 物件新增至集合。

屬性 Name 會對應至中之的 TreeNode TreeNodeCollection 索引鍵。

參數 imageKey 參考父 TreeView 系的屬性中的 ImageList 影像。

參數 selectedimageKey 參考父 TreeView 系的屬性中的 StateImageList 影像。

適用於

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

使用指定的索引鍵、文字和影像建立樹狀節點，並將它插入指定索引處的集合中。

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 或 AddRange 方法，將新 TreeNode 物件新增至集合。

屬性 Name 會對應至中之的 TreeNode TreeNodeCollection 索引鍵。

參數 imageIndex 參考父 TreeView 系的屬性中的 ImageList 影像。

參數 selectedimageIndex 參考父 TreeView 系的屬性中的 StateImageList 影像。

適用於

Insert(Int32, String, String, String)

使用指定的索引鍵、文字和影像建立樹狀節點，並將它插入指定索引處的集合中。

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 或 AddRange 方法，將新 TreeNode 物件新增至集合。

屬性 Name 會對應至中之的 TreeNode TreeNodeCollection 索引鍵。

參數 imageKey 參考父 TreeView 系的屬性中的 ImageList 影像。

適用於

Insert(Int32, String, String)

使用指定的文字和索引鍵建立樹狀節點，並將它插入集合中。

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 或 AddRange 方法，將新 TreeNode 物件新增至集合。

屬性 Name 會對應至中之的 TreeNode TreeNodeCollection 索引鍵。

適用於

Insert(Int32, TreeNode)

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

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 移除選取的樹狀節點，如果兩個樹狀節點集合不是唯讀的，請將它加入另一個樹狀節點。 Button按一下時， TreeNode 屬性所代表的 TreeView.SelectedNode 會使用方法從其中一個使用 Remove 方法刪除，並使用方法新增至另 TreeView Insert 一個 TreeView 。此範例需要您有包含兩 TreeView 個 Form 控制項和的 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 或 AddRange 方法，將新 TreeNode 物件新增至集合。

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

注意

TreeNode一次只能指派一個 TreeView 控制項。若要將樹狀節點新增至新的樹狀檢視控制項，您必須先將它從其他樹狀檢視中移除，或複製它。

適用於

Insert(Int32, String)

使用指定的文字建立樹狀節點，並將它插入指定的索引處。

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 或 AddRange 方法，將新 TreeNode 物件新增至集合。

適用於

Insert(Int32, String, String, Int32)

使用指定的索引鍵、文字和影像建立樹狀節點，並將它插入指定索引處的集合中。

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 或 AddRange 方法，將新 TreeNode 物件新增至集合。

屬性 Name 會對應至中之的 TreeNode TreeNodeCollection 索引鍵。

參數 imageIndex 參考父 TreeView 系的屬性中的 ImageList 影像。

適用於

共用方式為

TreeNodeCollection.Insert 方法

定義

多載

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)

參數

傳回

備註

適用於

其他資源