Form.ControlCollection.Add(Control) Método

Definición

Agrega un control al formulario.Adds a control to the form.

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.The Control to add to the form.

Excepciones

No se pueden agregar controles a un formulario MDI (interfaz de múltiples documentos) principal.A multiple document interface (MDI) parent form cannot have controls added to it.

Ejemplos

En el ejemplo de código siguiente se agrega un control TextBox y Label a la colección de controles de un formulario.The following code example adds a TextBox and Label control to the control collection of a form. El ejemplo requiere que se haya creado un formulario y que tenga el nombre Form1.The example requires that a form has been created and named 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.You can use this method to add controls to the form. Si desea agregar un grupo de controles ya creados al formulario, use el método Control.ControlCollection.AddRange de la clase Control.ControlCollection.If you want to add a group of already created controls to the form, use the Control.ControlCollection.AddRange method of the Control.ControlCollection class.

Se aplica a

Consulte también: