Form.ControlCollection.Add(Control) Método

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Agrega un control al formulario.

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

Control que se agrega al formulario.

Excepciones

Exception

No se pueden agregar controles a un formulario MDI (interfaz de múltiples documentos) principal.

Ejemplos

En el ejemplo de código siguiente se agrega un TextBox control y Label a la colección de controles de un formulario. El ejemplo requiere que se haya creado un formulario y se haya denominado 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

Comentarios

Puede usar este método para agregar controles al formulario. Si desea agregar un grupo de controles ya creados al formulario, use el Control.ControlCollection.AddRange método de la Control.ControlCollection clase .

Se aplica a

Consulte también

Remove(Control)