Control.ControlCollection.Remove(Control) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

从控件集合中移除指定的控件。

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)

参数

value

Control

要从 Control 移除的 Control.ControlCollection。

示例

如果派生类是集合的成员，则下面的代码示例从派生类Panel中删除 Control Control.ControlCollection a。 该示例要求你已创建一个Panel、一ButtonRadioButton个或多个控件Form。 控件 RadioButton 将添加到 Panel 控件，并将 Panel 控件添加到控件中 Form。 单击该按钮时，将从中Control.ControlCollection删除名为radioButton2的单选按钮。

   // 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

注解

从控件集合中删除 a Control 时，所有后续控件都将在集合中向上移动一个位置。

还可以使用RemoveAt该方法删除 a Control 控件，或使用该方法删除所有控件Clear。

若要向集合添加新 Control 对象，请使用 Add 或 AddRange 方法。

继承者说明

在派生类中重写 Remove(Control) 时，请务必调用基类 Remove(Control) 的方法，以确保控件从集合中删除。

另请参阅

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