Control.ControlCollection.Add(Control) Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Control.ControlCollection.cs

Hozzáadja a megadott vezérlőt a vezérlőgyűjteményhez.

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)

Paraméterek

value

Control

A Control vezérlőgyűjteményhez hozzáadni kívánt.

Kivételek

Exception

A megadott vezérlő egy legfelső szintű vezérlő, vagy körkörös vezérlési hivatkozás jelenik meg, ha ezt a vezérlőt hozzáadják a vezérlőgyűjteményhez.

ArgumentException

A paraméterhez value rendelt objektum nem egy Control.

Példák

Az alábbi példakód a származtatott osztályhoz ControlControl.ControlCollectionad hozzá egy Panel elemet. A példához létre kell hoznia egy vezérlőt és egy PanelButton vezérlőt egy Form. Ha a gombra kattint, a rendszer hozzáad egy TextBox vezérlőt a panelhez 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

Megjegyzések

A Add metódus lehetővé teszi objektumok hozzáadását Control a vezérlőgyűjtemény végéhez.

A metódussal új Control objektumokat is hozzáadhat a AddRange gyűjteményhez.

A korábban hozzáadott elemek Control eltávolításához használja az Remove, RemoveAtvagy Clear metódusokat.

Note

Az A Control egyszerre csak egyhez Control.ControlCollection rendelhető hozzá. Ha a Control vezérlő már egy másik vezérlő gyermeke, akkor a rendszer eltávolítja a vezérlőből, mielőtt hozzáadja egy másik vezérlőhöz.

Megjegyzések az öröklőkhöz

Származtatott osztály felülírásakor Add(Control) mindenképpen hívja meg az alaposztály metódusát Add(Control) , hogy a vezérlőelem hozzá legyen adva a gyűjteményhez.

Lásd még

• Remove(Control)
• RemoveAt(Int32)
• AddRange(Control[])