Control.ControlCollection.Add(Control) Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Adiciona o controle especificado à coleção de controle.

public:
 virtual void Add(System::Windows::Forms::Control ^ value);
public virtual void Add (System.Windows.Forms.Control value);
public virtual void Add (System.Windows.Forms.Control? value);
abstract member Add : System.Windows.Forms.Control -> unit
override this.Add : System.Windows.Forms.Control -> unit
Public Overridable Sub Add (value As Control)

Parâmetros

value
Control

O Control a adicionar à coleção de controles.

Exceções

Exception

O controle especificado é um controle de nível superior ou uma referência de controle circular resultaria caso esse controle fosse adicionado à coleção de controles.

ArgumentException

O objeto atribuído ao parâmetro value não é um Control.

Exemplos

O exemplo de código a seguir adiciona um Control à Control.ControlCollection classe Panelderivada. O exemplo requer que você tenha criado um Panel controle e um Button controle em um Form. Quando o botão é clicado, um TextBox controle é adicionado ao painel.Control.ControlCollection

   // Create a TextBox to add to the Panel.
private:
   TextBox^ textBox1;

   // Add controls to the Panel using the Add method.
   void addButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      textBox1 = gcnew TextBox;
      panel1->Controls->Add( textBox1 );
   }

// Create a TextBox to add to the Panel.
private TextBox textBox1 = new TextBox();

// Add controls to the Panel using the Add method.
private void addButton_Click(object sender, System.EventArgs e)
{
   panel1.Controls.Add(textBox1);
}

' Create a TextBox to add to the Panel.
Dim TextBox1 As TextBox = New TextBox()

' Add controls to the Panel using the Add method.
Private Sub AddButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles AddButton.Click
    Panel1.Controls.Add(TextBox1)
End Sub

Comentários

O Add método permite adicionar Control objetos ao final da coleção de controle.

Você também pode adicionar novos Control objetos à coleção usando o AddRange método.

Para remover um Control que você adicionou anteriormente, use o Remove, RemoveAtou Clear métodos.

Observação

Um Control só pode ser atribuído a um Control.ControlCollection de cada vez. Se o Control já for filho de outro controle, ele será removido desse controle antes de ser adicionado a outro controle.

Notas aos Herdeiros

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

Aplica-se a

Confira também