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再び並べ替えられます。

またはAddRangeメソッドを使用して、コレクションに新しいTreeNodeオブジェクトをAdd追加することもできます。

プロパティは 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。

注釈

またはAddRangeメソッドを使用して、コレクションに新しいTreeNodeオブジェクトをAdd追加することもできます。

プロパティは 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。

注釈

またはAddRangeメソッドを使用して、コレクションに新しいTreeNodeオブジェクトをAdd追加することもできます。

プロパティは 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。

注釈

またはAddRangeメソッドを使用して、コレクションに新しいTreeNodeオブジェクトをAdd追加することもできます。

プロパティは 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 に割り当てられています。

例

次のコード例では、選択したツリーノードを 1 つ TreeView から削除し、両方のツリーノードコレクションが読み取り専用でない場合は別のツリーノードに追加します。 a Button をクリックすると、TreeNodeプロパティによって表されるプロパティがメソッドをTreeView.SelectedNode使用して一方から削除され、メソッドを使用Removeしてもう一TreeView方TreeViewにInsert追加されます。この例では、Form2 つのコントロールと Button1 つのTreeViewコントロールを含む a が必要です。コントロールには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 。

またはAddRangeメソッドを使用して、コレクションに新しいTreeNodeオブジェクトをAdd追加することもできます。

以前に追加したファイルを削除TreeNodeするには、メソッド、またはClearメソッドRemoveAtをRemove使用します。

注意

A TreeNode は、一度に 1 つの 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。

注釈

またはAddRangeメソッドを使用して、コレクションに新しいTreeNodeオブジェクトをAdd追加することもできます。

適用対象

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。

注釈

またはAddRangeメソッドを使用して、コレクションに新しいTreeNodeオブジェクトをAdd追加することもできます。

プロパティは 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)

パラメーター

戻り値

注釈

適用対象

その他のリソース