Control.ControlCollection.Remove(Control) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
從控制項集合中移除指定的控制項。
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 -> unitPublic Overridable Sub Remove (value As Control)參數
- value
- Control
要從 Control 移除的 Control.ControlCollection。
範例
如果衍生類別是集合的成員，下列程式碼範例會 Control 從 Control.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 ，或使用 方法移除所有控制項 Clear 。 RemoveAt
若要將新 Control 物件加入至集合，請使用 Add 或 AddRange 方法。
給繼承者的注意事項
在 Remove(Control) 衍生類別中覆寫時，請務必呼叫基類的 Remove(Control) 方法，以確保控制項已從集合中移除。