Form.ControlCollection.Add(Control) Método

Definição

Adiciona um controlo à forma.

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

Parâmetros

value
Control

O Control para adicionar ao formulário.

Exceções

Um formulário pai de múltipla interface de documentos (MDI) não pode ter controlos adicionados.

Exemplos

O seguinte exemplo de código adiciona um TextBox e Label controlo à coleção de controlos de um formulário. O exemplo exige que uma forma tenha sido criada e nomeada Form1.

public:
   void AddMyControls()
   {
      TextBox^ textBox1 = gcnew TextBox;
      Label^ label1 = gcnew Label;
      
      // Initialize the controls and their bounds.
      label1->Text = "First Name";
      label1->Location = Point( 48, 48 );
      label1->Size = System::Drawing::Size( 104, 16 );
      textBox1->Text = "";
      textBox1->Location = Point(48,64);
      textBox1->Size = System::Drawing::Size( 104, 16 );
      
      // Add the TextBox control to the form's control collection.
      Controls->Add( textBox1 );
      // Add the Label control to the form's control collection.
      Controls->Add( label1 );
   }
public void AddMyControls()
 {
    TextBox textBox1 = new TextBox();
    Label label1 = new Label();
    
    // Initialize the controls and their bounds.
    label1.Text = "First Name";
    label1.Location = new Point(48,48);
    label1.Size = new Size (104, 16);
    textBox1.Text = "";
    textBox1.Location = new Point(48, 64);
    textBox1.Size = new Size(104,16);
 
    // Add the TextBox control to the form's control collection.
    Controls.Add(textBox1);
    // Add the Label control to the form's control collection.
    Controls.Add(label1);
 }
Public Sub AddMyControls()
    Dim textBox1 As New TextBox()
    Dim label1 As New Label()
    
    ' Initialize the controls and their bounds.
    label1.Text = "First Name"
    label1.Location = New Point(48, 48)
    label1.Size = New Size(104, 16)
    textBox1.Text = ""
    textBox1.Location = New Point(48, 64)
    textBox1.Size = New Size(104, 16)
    
    ' Add the TextBox control to the form's control collection.
    Controls.Add(textBox1)
    ' Add the Label control to the form's control collection.
    Controls.Add(label1)
End Sub

Observações

Pode usar este método para adicionar controlos ao formulário. Se quiseres adicionar um grupo de controlos já criados ao formulário, usa o Control.ControlCollection.AddRange método da Control.ControlCollection classe.

Aplica-se a

Ver também