Control.ControlCollection.Remove(Control) Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Quita el control especificado de la colección de controles.

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)

Parámetros

value
Control

Control que se va a quitar de Control.ControlCollection.

Ejemplos

En el ejemplo de código siguiente se quita un Control elemento de de la Control.ControlCollection clase Panel derivada si es miembro de la colección. En el ejemplo se requiere que haya creado un Panel, y Buttonuno o varios RadioButton controles en .Form Los RadioButton controles se agregan al Panel control y el Panel control se agrega a Form. Cuando se hace clic en el botón, el botón de radio denominado radioButton2 se quita de .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

Comentarios

Cuando se quita un Control elemento de la colección de controles, todos los controles subsiguientes se mueven hacia arriba una posición de la colección.

También puede quitar un Control mediante el RemoveAt método o quitar todos los controles mediante el Clear método .

Para agregar nuevos Control objetos a la colección, use los Add métodos o AddRange .

Notas a los desarrolladores de herederos

Al invalidar Remove(Control) en una clase derivada, asegúrese de llamar al método de Remove(Control) la clase base para asegurarse de que el control se quita de la colección.

Se aplica a

Consulte también