共用方式為


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)

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

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 再次排序 。

您也可以使用 AddAddRange 方法,將新 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 再次排序 。

您也可以使用 AddAddRange 方法,將新 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 再次排序 。

您也可以使用 AddAddRange 方法,將新 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 再次排序 。

您也可以使用 AddAddRange 方法,將新 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

例外狀況

node 目前已指派給其他 TreeView

範例

下列程式碼範例會從其中一個 TreeView 移除選取的樹狀節點,如果兩個樹狀節點集合不是唯讀的,請將它加入另一個樹狀節點。 Button按一下 時, TreeNode 屬性所代表的 TreeView.SelectedNode 會使用 方法從其中一個使用 Remove 方法刪除,並使用 方法新增至另 TreeView Insert 一個 TreeView 。 此範例需要您有 包含兩 TreeViewForm 控制項和 的 Button 。 控制項 TreeView 應該命名為 treeView1treeView2

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 取用的 。

您也可以使用 AddAddRange 方法,將新 TreeNode 物件新增至集合。

若要移除您先前新增的 TreeNode ,請使用 RemoveRemoveAtClear 方法。

注意

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 再次排序 。

您也可以使用 AddAddRange 方法,將新 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 再次排序 。

您也可以使用 AddAddRange 方法,將新 TreeNode 物件新增至集合。

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

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

適用於