共用方式為


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)

參數

value
Control

要從 Control 移除的 Control.ControlCollection

範例

如果衍生類別是集合的成員,下列程式碼範例會 ControlControl.ControlCollection 衍生類別 Panel 的 移除 。 此範例會要求您已在 上建立 Panel 、、 Button 和一或多個 RadioButton 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

備註

Control從控制項集合中移除 時,所有後續控制項都會向上移動集合中的一個位置。

您也可以使用 方法來移除 Control ,或使用 方法移除所有控制項 ClearRemoveAt

若要將新 Control 物件加入至集合,請使用 AddAddRange 方法。

給繼承者的注意事項

Remove(Control) 衍生類別中覆寫時,請務必呼叫基類的 Remove(Control) 方法,以確保控制項已從集合中移除。

適用於

另請參閱