TreeNodeCollection.Clear メソッド

コレクションからすべてのツリー ノードを削除します。

Public Overridable Sub Clear() Implements IList.Clear
[C#]
public virtual void Clear();
[C++]
public: virtual void Clear();
[JScript]
public function Clear();

実装

IList.Clear

解説

このメソッドを使用すると、ツリー ビューからツリー ノードのコレクション全体を削除できます。

コレクションからツリー ノードを個別に削除するには、 Remove メソッドまたは RemoveAt メソッドを使用します。

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

使用例

[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 名前空間