Control.ControlCollection.Clear メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.ControlCollection.Clear メソッド

コレクションからすべてのコントロールを削除します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub Clear

Visual Basic (使用法)

Dim instance As ControlCollection

instance.Clear

public virtual void Clear ()

C++

public:
virtual void Clear ()

public void Clear ()

JScript

public function Clear ()

解説

Clear メソッドを使用して、親コントロールからコントロールのコレクション全体を削除できます。

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

重要 :
Clear メソッドを呼び出しても、コントロールのハンドルがメモリから削除されることはありません。メモリリークを防ぐには、Dispose メソッドを明示的に呼び出す必要があります。

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

継承時の注意 派生クラスで Clear をオーバーライドする場合は、基本クラスの Clear メソッドを呼び出して、確実にすべてのコントロールがコレクションから削除されるようにしてください。

使用例

派生クラス Panel の Control.ControlCollection に含まれるすべての Control オブジェクトを削除するコード例を次に示します。この例では、Form 上に、Panel、Button、および 1 つ以上のその他のコントロールが作成されている必要があります。その他のコントロールは Panel コントロールに追加され、Panel は Form に追加されます。ボタンがクリックされると、パネルに含まれているすべてのコントロールが Control.ControlCollection から削除されます。

Visual Basic

' Clear all the controls in the Panel.
Private Sub ClearButton_Click(ByVal
 sender As System.Object, _
    ByVal e As System.EventArgs) Handles
 ClearButton.Click
    Panel1.Controls.Clear()
End Sub

// Clear all the controls in the Panel.
private void clearButton_Click(object sender,
 System.EventArgs e)
{
   panel1.Controls.Clear();
}

C++

   // Clear all the controls in the Panel.
private:
   void clearButton_Click( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      panel1->Controls->Clear();
   }

// Clear all the controls in the Panel.
private void clearButton_Click(Object sender,
 System.EventArgs e)
{
    panel1.get_Controls().Clear();
} //clearButton_Click