Compartilhar via


Control.ControlCollection.RemoveAt(Int32) Método

Definição

Remove um controle da coleção de controles no local indexado especificado.

public:
 virtual void RemoveAt(int index);
public void RemoveAt (int index);
abstract member RemoveAt : int -> unit
override this.RemoveAt : int -> unit
Public Sub RemoveAt (index As Integer)

Parâmetros

index
Int32

O valor de índice do Control a ser removido.

Implementações

Exemplos

O exemplo de código a Control.ControlCollection seguir remove o primeiro Control da classe Panel derivada se a contagem da coleção for maior que zero. O exemplo requer que você tenha criado um Panel, um Buttone pelo menos um outro controle em um Form. Os outros controles são adicionados ao Panel controle e o Panel controle adicionado ao Form. Quando o botão é clicado, o primeiro controle contido no painel é removido do Control.ControlCollection.

   // Remove the first control in the collection.
private:
   void removeAtButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( panel1->Controls->Count > 0 )
      {
         panel1->Controls->RemoveAt( 0 );
      }
   }
// Remove the first control in the collection.
private void removeAtButton_Click(object sender, System.EventArgs e)
{
   if (panel1.Controls.Count > 0)
   {
      panel1.Controls.RemoveAt(0);
   }
}
' Remove the first control in the collection.
Private Sub RemoveAtButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveAtButton.Click
    If (Panel1.Controls.Count > 0) Then
        Panel1.Controls.RemoveAt(0)
    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 que você adicionou anteriormente usando os métodos ou Clear os Remove métodos.

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

Aplica-se a

Confira também