TreeNodeCollection.AddRange メソッド

以前に作成したツリー ノードの配列をコレクションに追加します。

Public Overridable Sub AddRange( _
   ByVal nodes() As TreeNode _)
[C#]
public virtual void AddRange(TreeNode[] nodes);
[C++]
public: virtual void AddRange(TreeNode* nodes[]);
[JScript]
public function AddRange(
   nodes : TreeNode[]);

パラメータ

• nodes
  コレクションに追加するツリー ノードを表す TreeNode オブジェクトの配列。

解説

nodes 配列に格納されている複数の TreeNode オブジェクトが、コレクションの末尾に追加されます。

AddRange メソッドを使用すると、 Add メソッドを使用して TreeNode を 1 つずつ手動でコレクションに追加するのではなく、以前に作成した TreeNode オブジェクトのグループをすばやくコレクションに追加できます。

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

使用例

[Visual Basic, C#, C++] TreeNodeCollection を TreeView から一時的な Array にコピーし、この配列の内容を AddRange メソッドを使用して別の TreeView に追加する例を次に示します。元の TreeView の TreeNodeCollection は、 Clear メソッドによって削除されます。この例は、 TreeView コントロールが 2 つあり、一方には TreeNode オブジェクトのコレクションがあることを前提にしています。

 
Private Sub MyButtonAddAllClick(sender As Object, e As EventArgs)
   ' Get the 'myTreeNodeCollection' from the 'myTreeViewBase' TreeView.
   Dim myTreeNodeCollection As TreeNodeCollection = myTreeViewBase.Nodes
   ' Create an array of 'TreeNodes'.
   Dim myTreeNodeArray(myTreeViewBase.Nodes.Count-1) As TreeNode
   ' Copy the tree nodes to the 'myTreeNodeArray' array.
   myTreeViewBase.Nodes.CopyTo(myTreeNodeArray, 0)
   ' Remove all the tree nodes from the 'myTreeViewBase' TreeView.
   myTreeViewBase.Nodes.Clear()
   ' Add the 'myTreeNodeArray' to the 'myTreeViewCustom' TreeView.
      myTreeViewCustom.Nodes.AddRange(myTreeNodeArray)
End Sub

[C#] 
private void MyButtonAddAllClick(object sender, EventArgs e)
{
   // Get the 'myTreeNodeCollection' from the 'myTreeViewBase' TreeView.
   TreeNodeCollection myTreeNodeCollection = myTreeViewBase.Nodes;
   // Create an array of 'TreeNodes'.
   TreeNode[] myTreeNodeArray = new TreeNode[myTreeViewBase.Nodes.Count];
   // Copy the tree nodes to the 'myTreeNodeArray' array.
   myTreeViewBase.Nodes.CopyTo(myTreeNodeArray,0);
   // Remove all the tree nodes from the 'myTreeViewBase' TreeView.
   myTreeViewBase.Nodes.Clear();
   // Add the 'myTreeNodeArray' to the 'myTreeViewCustom' TreeView.
   myTreeViewCustom.Nodes.AddRange(myTreeNodeArray);
}

[C++] 
private:
    void MyButtonAddAllClick(Object* /*sender*/, EventArgs* /*e*/) {
        // Get the 'myTreeNodeCollection' from the 'myTreeViewBase' TreeView.
        TreeNodeCollection* myTreeNodeCollection = myTreeViewBase->Nodes;
        // Create an array of 'TreeNodes'.
        TreeNode* myTreeNodeArray[] = new TreeNode*[myTreeViewBase->Nodes->Count];
        // Copy the tree nodes to the 'myTreeNodeArray' array.
        myTreeViewBase->Nodes->CopyTo(myTreeNodeArray, 0);
        // Remove all the tree nodes from the 'myTreeViewBase' TreeView.
        myTreeViewBase->Nodes->Clear();
        // Add the 'myTreeNodeArray' to the 'myTreeViewCustom' TreeView.
        myTreeViewCustom->Nodes->AddRange(myTreeNodeArray);
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

TreeNodeCollection クラス | TreeNodeCollection メンバ | System.Windows.Forms 名前空間 | Add | CopyTo