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

public:
 virtual void Remove(System::Windows::Forms::Control ^ value);

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)

パラメーター

例

次のコード例では、Controlがコレクションのメンバーである場合にControl.ControlCollection派生クラスのPanelから削除します。 この例では、PanelにButton、RadioButton、および 1 つ以上の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) メソッドを呼び出して、コントロールがコレクションから確実に削除されるようにしてください。

こちらもご覧ください

• RemoveAt(Int32)
• Clear()
• Add(Control)