다음을 통해 공유


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 다시 정렬됩니다.

또는 AddRange 메서드를 사용하여 컬렉션에 새 TreeNode 개체를 Add 추가할 수도 있습니다.

Name 키에 해당 하는 속성을 TreeNodeTreeNodeCollection합니다.

매개 변수는 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 다시 정렬됩니다.

또는 AddRange 메서드를 사용하여 컬렉션에 새 TreeNode 개체를 Add 추가할 수도 있습니다.

Name 키에 해당 하는 속성을 TreeNodeTreeNodeCollection합니다.

매개 변수는 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 다시 정렬됩니다.

또는 AddRange 메서드를 사용하여 컬렉션에 새 TreeNode 개체를 Add 추가할 수도 있습니다.

Name 키에 해당 하는 속성을 TreeNodeTreeNodeCollection합니다.

매개 변수는 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 다시 정렬됩니다.

또는 AddRange 메서드를 사용하여 컬렉션에 새 TreeNode 개체를 Add 추가할 수도 있습니다.

Name 키에 해당 하는 속성을 TreeNodeTreeNodeCollection합니다.

적용 대상

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 나타내는 메서드를 사용 하 여 하나에서 TreeView 삭제 하 고 메서드를 사용 하 여 Remove Insert 다른 TreeView 추가 됩니다. 이 예제에서는 두 개의 TreeView 컨트롤과 Buttona Form 를 포함하는 컨트롤이 있어야 합니다. 컨트롤의 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 항목을 제거하려면 , RemoveAt또는 Clear 메서드를 Remove사용합니다.

참고

A는 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 다시 정렬됩니다.

또는 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입니다.

설명

속성이 Sorted 설정된 true``index 경우 매개 변수 값은 무시됩니다. 트리 TreeNode 뷰에 삽입되고 TreeView 다시 정렬됩니다.

또는 AddRange 메서드를 사용하여 컬렉션에 새 TreeNode 개체를 Add 추가할 수도 있습니다.

Name 키에 해당 하는 속성을 TreeNodeTreeNodeCollection합니다.

매개 변수는 imageIndex 부모 TreeView속성의 ImageList 이미지를 참조합니다.

적용 대상