Control.ControlCollection.Add(Control) Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Agrega el control especificado a la colección de controles.

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

Control que se va a agregar a la colección.

Excepciones

Exception

El control especificado es de nivel superior o se producirá una referencia circular a un control si éste se agregó a la colección de controles.

ArgumentException

El objeto asignado al parámetro value no es un Control.

Ejemplos

En el ejemplo de código siguiente se agrega a Control de Control.ControlCollection la clase Panelderivada . El ejemplo requiere que haya creado un Panel control y un Button control en .Form Cuando se hace clic en el botón, se agrega un TextBox control al panel.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

Comentarios

El Add método permite agregar Control objetos al final de la colección de controles.

También puede agregar nuevos Control objetos a la colección mediante el AddRange método .

Para quitar un Control objeto que agregó anteriormente, use los Removemétodos , RemoveAto Clear .

Nota

Solo Control se puede asignar un objeto a uno Control.ControlCollection cada vez. Control Si ya es un elemento secundario de otro control, se quita de ese control antes de agregarlo a otro control.

Notas a los desarrolladores de herederos

Al invalidar Add(Control) en una clase derivada, asegúrese de llamar al método de Add(Control) la clase base para asegurarse de que el control se agrega a la colección.

Se aplica a

Consulte también