TreeNodeCollection.Insert メソッド

定義

コレクション内の指定した位置に項目を挿入します。Inserts an item in the collection at a specified location.

オーバーロード

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

指定したキー、テキスト、およびイメージを使用してツリー ノードを作成し、コレクション内の指定したインデックス位置に挿入します。Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.

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

指定したキー、テキスト、およびイメージを使用してツリー ノードを作成し、コレクション内の指定したインデックス位置に挿入します。Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.

Insert(Int32, String, String, String)

指定したキー、テキスト、およびイメージを使用してツリー ノードを作成し、コレクション内の指定したインデックス位置に挿入します。Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.

Insert(Int32, String, String)

指定したテキストとキーを使用してツリー ノードを作成し、コレクションに挿入します。Creates a tree node with the specified text and key, and inserts it into the collection.

Insert(Int32, TreeNode)

ツリー ノード コレクション内の指定した位置に既存のツリー ノードを挿入します。Inserts an existing tree node into the tree node collection at the specified location.

Insert(Int32, String)

指定したテキストを使用してツリー ノードを作成し、指定したインデックスに挿入します。Creates a tree node with the specified text and inserts it at the specified index.

Insert(Int32, String, String, Int32)

指定したキー、テキスト、およびイメージを使用してツリー ノードを作成し、コレクション内の指定したインデックス位置に挿入します。Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.

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

指定したキー、テキスト、およびイメージを使用してツリー ノードを作成し、コレクション内の指定したインデックス位置に挿入します。Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.

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

ノードを挿入するコレクション内の位置。The location within the collection to insert the node.

key
String

ツリー ノードの名前。The name of the tree node.

text
String

ツリー ノードに表示するテキスト。The text to display in the tree node.

imageKey
String

ツリー ノードに表示するイメージのキー。The key of the image to display in the tree node.

selectedImageKey
String

ツリー ノードが選択されている状態のときに表示するイメージのキー。The key of the image to display in the tree node when it is in a selected state.

戻り値

コレクションに挿入された TreeNodeThe TreeNode that was inserted in the collection.

注釈

プロパティがSortedtrue設定されているindex場合、パラメーター値は無視されます。If the Sorted property is set to true, the index parameter value is ignored. がツリービュー TreeViewに挿入され、が再度並べ替えられます。TreeNodeThe TreeNode is inserted into the tree view and the TreeView is sorted again.

また、 TreeNode AddメソッドまたはAddRangeメソッドを使用して、コレクションに新しいオブジェクトを追加することもできます。You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

プロパティNameTreeNodeTreeNodeCollectionののキーに対応します。The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

パラメーター imageKeyは、 ImageListTreeViewのプロパティ内のイメージを参照します。The imageKey parameter refers to an image in the ImageList property of the parent TreeView.

パラメーター selectedimageKeyは、 StateImageListTreeViewのプロパティ内のイメージを参照します。The selectedimageKey parameter refers to an image in the StateImageList property of the parent TreeView.

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

指定したキー、テキスト、およびイメージを使用してツリー ノードを作成し、コレクション内の指定したインデックス位置に挿入します。Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.

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

ノードを挿入するコレクション内の位置。The location within the collection to insert the node.

key
String

ツリー ノードの名前。The name of the tree node.

text
String

ツリー ノードに表示するテキスト。The text to display in the tree node.

imageIndex
Int32

ツリー ノードに表示するイメージのインデックス。The index of the image to display in the tree node.

selectedImageIndex
Int32

ツリー ノードが選択されている状態のときに表示するイメージのインデックス。The index of the image to display in the tree node when it is in a selected state.

戻り値

コレクションに挿入された TreeNodeThe TreeNode that was inserted in the collection.

注釈

プロパティがSortedtrue設定されているindex場合、パラメーター値は無視されます。If the Sorted property is set to true, the index parameter value is ignored. がツリービュー TreeViewに挿入され、が再度並べ替えられます。TreeNodeThe TreeNode is inserted into the tree view and the TreeView is sorted again.

また、 TreeNode AddメソッドまたはAddRangeメソッドを使用して、コレクションに新しいオブジェクトを追加することもできます。You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

プロパティNameTreeNodeTreeNodeCollectionののキーに対応します。The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

パラメーター imageIndexは、 ImageListTreeViewのプロパティ内のイメージを参照します。The imageIndex parameter refers to an image in the ImageList property of the parent TreeView.

パラメーター selectedimageIndexは、 StateImageListTreeViewのプロパティ内のイメージを参照します。The selectedimageIndex parameter refers to an image in the StateImageList property of the parent TreeView.

Insert(Int32, String, String, String)

指定したキー、テキスト、およびイメージを使用してツリー ノードを作成し、コレクション内の指定したインデックス位置に挿入します。Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.

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

ノードを挿入するコレクション内の位置。The location within the collection to insert the node.

key
String

ツリー ノードの名前。The name of the tree node.

text
String

ツリー ノードに表示するテキスト。The text to display in the tree node.

imageKey
String

ツリー ノードに表示するイメージのキー。The key of the image to display in the tree node.

戻り値

コレクションに挿入された TreeNodeThe TreeNode that was inserted in the collection.

注釈

プロパティがSortedtrue設定されているindex場合、パラメーター値は無視されます。If the Sorted property is set to true, the index parameter value is ignored. がツリービュー TreeViewに挿入され、が再度並べ替えられます。TreeNodeThe TreeNode is inserted into the tree view and the TreeView is sorted again.

また、 TreeNode AddメソッドまたはAddRangeメソッドを使用して、コレクションに新しいオブジェクトを追加することもできます。You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

プロパティNameTreeNodeTreeNodeCollectionののキーに対応します。The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

パラメーター imageKeyは、 ImageListTreeViewのプロパティ内のイメージを参照します。The imageKey parameter refers to an image in the ImageList property of the parent TreeView.

Insert(Int32, String, String)

指定したテキストとキーを使用してツリー ノードを作成し、コレクションに挿入します。Creates a tree node with the specified text and key, and inserts it into the collection.

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

ノードを挿入するコレクション内の位置。The location within the collection to insert the node.

key
String

ツリー ノードの名前。The name of the tree node.

text
String

ツリー ノードに表示するテキスト。The text to display in the tree node.

戻り値

コレクションに挿入された TreeNodeThe TreeNode that was inserted in the collection.

注釈

プロパティがSortedtrue設定されているindex場合、パラメーター値は無視されます。If the Sorted property is set to true, the index parameter value is ignored. がツリービュー TreeViewに挿入され、が再度並べ替えられます。TreeNodeThe TreeNode is inserted into the tree view and the TreeView is sorted again.

また、 TreeNode AddメソッドまたはAddRangeメソッドを使用して、コレクションに新しいオブジェクトを追加することもできます。You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

プロパティNameTreeNodeTreeNodeCollectionののキーに対応します。The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

Insert(Int32, TreeNode)

ツリー ノード コレクション内の指定した位置に既存のツリー ノードを挿入します。Inserts an existing tree node into the tree node collection at the specified location.

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

ツリー ノードを挿入するコレクション内の位置を示すインデックス。The indexed location within the collection to insert the tree node.

node
TreeNode

コレクションに挿入する TreeNodeThe TreeNode to insert into the collection.

例外

node が、現在別の TreeView に割り当てられています。The node is currently assigned to another TreeView.

次のコード例では、選択したツリー TreeViewノードを1つから削除し、両方のツリーノードコレクションが読み取り専用でない場合は、それを別のツリーノードに追加します。The following code example removes the selected tree node from one TreeView and adds it to another if both tree node collections are not read-only. ButtonをクリックTreeView Insert TreeView Removeすると、 TreeView.SelectedNodeプロパティによって表されるがメソッドを使用して1つから削除され、メソッドを使用して別のに追加されます。TreeNodeWhen a Button is clicked, the TreeNode represented by the TreeView.SelectedNode property is deleted from one TreeView using the Remove method and added to the other TreeView using the Insert method. この例では、2つForm TreeViewのコントロールとButtonが含まれたが必要です。This example requires that you have a Form that contains two TreeView controls and a Button. コントロールTreeViewの名前treeView1はとtreeView2にする必要があります。The TreeView controls should be named treeView1 and 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.Sortedtrue設定されているindex場合、パラメーター値は無視されます。If the TreeView.Sorted property is set to true, the index parameter value is ignored. がツリービュー TreeViewに挿入され、が並べ替えられます。 TreeNodeThe TreeNode is inserted into the tree view, and the TreeView resorted.

また、 TreeNode AddメソッドまたはAddRangeメソッドを使用して、コレクションに新しいオブジェクトを追加することもできます。You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

以前に追加TreeNodeしたを削除するにはRemove、メソッド、 Clearメソッド、またはメソッドを使用RemoveAtします。To remove a TreeNode that you previously added, use the Remove, RemoveAt, or Clear methods.

注意

TreeNode一度に1つTreeViewのコントロールにのみ割り当てることができます。A TreeNode can be assigned to only one TreeView control at a time. ツリーノードを新しいツリービューコントロールに追加するには、最初に他のツリービューから削除するか、複製する必要があります。To add the tree node to a new tree view control, you must remove it from the other tree view first or clone it.

Insert(Int32, String)

指定したテキストを使用してツリー ノードを作成し、指定したインデックスに挿入します。Creates a tree node with the specified text and inserts it at the specified index.

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

ノードを挿入するコレクション内の位置。The location within the collection to insert the node.

text
String

ツリー ノードに表示するテキスト。The text to display in the tree node.

戻り値

コレクションに挿入された TreeNodeThe TreeNode that was inserted in the collection.

注釈

プロパティがSortedtrue設定されているindex場合、パラメーター値は無視されます。If the Sorted property is set to true, the index parameter value is ignored. がツリービュー TreeViewに挿入され、が再度並べ替えられます。TreeNodeThe TreeNode is inserted into the tree view and the TreeView is sorted again.

また、 TreeNode AddメソッドまたはAddRangeメソッドを使用して、コレクションに新しいオブジェクトを追加することもできます。You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

Insert(Int32, String, String, Int32)

指定したキー、テキスト、およびイメージを使用してツリー ノードを作成し、コレクション内の指定したインデックス位置に挿入します。Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.

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

ノードを挿入するコレクション内の位置。The location within the collection to insert the node.

key
String

ツリー ノードの名前。The name of the tree node.

text
String

ツリー ノードに表示するテキスト。The text to display in the tree node.

imageIndex
Int32

ツリー ノードに表示するイメージのインデックス。The index of the image to display in the tree node.

戻り値

コレクションに挿入された TreeNodeThe TreeNode that was inserted in the collection.

注釈

プロパティがSortedtrue設定されているindex場合、パラメーター値は無視されます。If the Sorted property is set to true, the index parameter value is ignored. がツリービュー TreeViewに挿入され、が再度並べ替えられます。TreeNodeThe TreeNode is inserted into the tree view and the TreeView is sorted again.

また、 TreeNode AddメソッドまたはAddRangeメソッドを使用して、コレクションに新しいオブジェクトを追加することもできます。You can also add new TreeNode objects to the collection by using the Add or AddRange methods.

プロパティNameTreeNodeTreeNodeCollectionののキーに対応します。The Name property corresponds to the key for a TreeNode in the TreeNodeCollection.

パラメーター imageIndexは、 ImageListTreeViewのプロパティ内のイメージを参照します。The imageIndex parameter refers to an image in the ImageList property of the parent TreeView.

適用対象