Compartilhar via


Control.ControlCollection.Remove(Control) Método

Definição

Remove o controle especificado da coleção do controle.

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

O Control a ser removido de Control.ControlCollection.

Exemplos

O exemplo de código a Control.ControlCollection seguir remove um Control da classe Panel derivada se ele for um membro da coleção. O exemplo requer que você tenha criado um Panel, um e um Buttonou mais RadioButton controles em um Form. Os RadioButton controles são adicionados ao Panel controle e o Panel controle é adicionado ao Form. Quando o botão é clicado, o botão de opção nomeado radioButton2 é removido do 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

Comentários

Quando um Control é removido da coleção de controles, todos os controles subsequentes são movidos para cima uma posição na coleção.

Você também pode remover um Control usando o RemoveAt método ou remover todos os controles usando o Clear método.

Para adicionar novos Control objetos à coleção, use os métodos ou AddRange os Add métodos.

Notas aos Herdeiros

Ao substituir Remove(Control) em uma classe derivada, chame o método da Remove(Control) classe base para garantir que o controle seja removido da coleção.

Aplica-se a

Confira também