Control.ControlCollection.Add(Control) Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Přidá zadaný ovládací prvek do kolekce ovládacích prvků.

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)

Parametry

value
Control

Přidání Control do kolekce ovládacích prvků

Výjimky

Exception

Zadaný ovládací prvek je ovládací prvek nejvyšší úrovně nebo cyklický odkaz na ovládací prvek by byl výsledkem, pokud by byl tento ovládací prvek přidán do kolekce ovládacích prvků.

ArgumentException

Objekt přiřazený k parametru value není Control.

Příklady

Následující příklad kódu přidá do Control Control.ControlCollection odvozené třídy Panel. Příklad vyžaduje, abyste vytvořili Panel ovládací prvek a Button ovládací prvek na ovládacím Formprvku . Po kliknutí na TextBox tlačítko se do panelu Control.ControlCollectionpřidá ovládací prvek .

   // 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

Poznámky

Metoda Add umožňuje přidat Control objekty na konec kolekce ovládacích prvků.

Do kolekce můžete také přidat nové Control objekty pomocí AddRange metody.

Pokud chcete odebrat dříve přidaný Control soubor, použijte metodu Remove, nebo .Clear RemoveAt

Poznámka

A Control lze přiřadit pouze k jednomu Control.ControlCollection najednou. Control Pokud už je podřízený jiný ovládací prvek, odebere se z tohoto ovládacího prvku předtím, než se přidá do jiného ovládacího prvku.

Poznámky pro dědice

Při přepsání Add(Control) v odvozené třídě nezapomeňte volat metodu základní třídy Add(Control) , aby se zajistilo, že je ovládací prvek přidán do kolekce.

Platí pro

Viz také