Control.ControlCollection.Remove(Control) 메서드


컨트롤 컬렉션에서 지정된 컨트롤을 제거합니다.Removes the specified control from the control collection.

 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입니다.The Control to remove from the Control.ControlCollection.


다음 코드 예제에서는 Control Control.ControlCollection Panel 컬렉션의 멤버인 경우 파생 클래스의에서를 제거 합니다.The following code example removes a Control from the Control.ControlCollection of the derived class Panel if it is a member of the collection. 이 예제를 사용 하려면에 Panel , Button 및 하나 이상의 컨트롤을 만들어야 RadioButton Form 합니다.The example requires that you have created a Panel, a Button, and one or more RadioButton controls on a Form. 컨트롤이 RadioButton 컨트롤에 추가 되 PanelPanel 컨트롤이에 추가 됩니다 Form .The RadioButton controls are added to the Panel control, and the Panel control is added to the Form. 단추를 클릭 하면 라는 라디오 단추가에서 radioButton2 제거 됩니다 Control.ControlCollection .When the button is clicked, the radio button named radioButton2 is removed from the Control.ControlCollection.

   // Remove the RadioButton control if it exists.
   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)
' 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
    End If
End Sub


Control컨트롤 컬렉션에서이 제거 되 면 모든 후속 컨트롤이 컬렉션에서 한 위치 위로 이동 합니다.When a Control is removed from the control collection, all subsequent controls are moved up one position in the collection.

제거할 수도 있습니다는 Control 를 사용 하 여 합니다 RemoveAt 메서드 또는 모든 제어를 사용 하 여 제거를 Clear 메서드.You can also remove a Control by using the RemoveAt method, or remove all controls by using the Clear method.

새로 추가 하려면 Control 컬렉션에 개체를 사용 합니다 Add 또는 AddRange 메서드.To add new Control objects to the collection, use the Add or AddRange methods.

상속자 참고

파생 클래스에서 재정의 하는 경우 Remove(Control) 기본 클래스의 메서드를 호출 하 여 Remove(Control) 컨트롤이 컬렉션에서 제거 되도록 해야 합니다.When overriding Remove(Control) in a derived class, be sure to call the base class's Remove(Control) method to ensure that the control is removed from the collection.

적용 대상

추가 정보