Control.ControlCollection.Remove(Control) メソッド

定義

指定したコントロールをコントロール コレクションから削除します。

public:
 virtual void Remove(System::Windows::Forms::Control ^ value);
public virtual void Remove (System.Windows.Forms.Control value);
abstract member Remove : System.Windows.Forms.Control -> unit
override this.Remove : System.Windows.Forms.Control -> unit
Public Overridable Sub Remove (value As Control)

パラメーター

value
Control

Control から削除する Control.ControlCollection

次のコード例では、 がコレクションのメンバーである場合、派生クラスの から Control Control.ControlCollection Panel を削除します。 この例では、 で、、および 1 つ以上 Panel Button の コントロールを作成 RadioButton している必要があります Form 。 コントロール RadioButton が コントロールに追加 Panel され、 コントロール Panel が に追加されます Form 。 ボタンをクリックすると、 という名前のラジオ ボタン radioButton2 が から削除されます Control.ControlCollection

   // Remove the RadioButton control if it exists.
private:
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( panel1->Controls->Contains( removeButton ) )
      {
         panel1->Controls->Remove( removeButton );
      }
   }
// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}
' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveButton.Click
    If Panel1.Controls.Contains(RemoveButton) Then
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

注釈

がコントロール Control コレクションから削除されると、後続のすべてのコントロールがコレクション内の 1 つの位置に移動されます。

メソッドを使用して を削除したり、 メソッドを使用してすべての Control RemoveAt コントロールを削除 Clear したりもできます。

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

注意 (継承者)

派生クラスでオーバーライドする場合は、必ず基本クラスの メソッドを呼び出して、コントロールがコレクションから削除 Remove(Control) Remove(Control) されます。

適用対象

こちらもご覧ください