Control.ControlCollection.Add(Control) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Adiciona o controlo especificado à coleção de controlos.
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 -> unitPublic Overridable Sub Add (value As Control)Parâmetros
Exceções
O controlo especificado é um controlo de nível superior, ou resultaria uma referência circular de controlo se este controlo fosse adicionado à coleção de controlos.
O objeto atribuído ao value parâmetro não é um Control.
Exemplos
O seguinte exemplo de código adiciona a Control ao Control.ControlCollection da classe Panelderivada . O exemplo exige que tenha criado um Panel controlo e um Button controlo sobre um Form. Quando o botão é pressionado, um TextBox controlo é adicionado ao Control.ControlCollectionpainel .
// 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
Observações
O Add método permite-lhe adicionar Control objetos ao final da coleção de controlos.
Também pode adicionar novos Control objetos à coleção usando o AddRange método.
Para remover um Control que adicionou anteriormente, use os Removemétodos , RemoveAt, ou Clear .
Note
A Control só pode ser atribuído a um Control.ControlCollection de cada vez. Se o Control já for filho de outro controlo, é removido desse controlo antes de ser adicionado a outro controlo.
Notas para Herdeiros
Ao sobrescrever Add(Control) numa classe derivada, certifique-se de chamar o método da Add(Control) classe base para garantir que o controlo é adicionado à coleção.
