Control.ControlCollection.Add(Control) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

Control.ControlCollection.cs

Dodaje określoną kontrolkę do kolekcji kontrolek.

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

Element Control do dodania do kolekcji kontrolek.

Wyjątki

Exception

Określona kontrolka jest kontrolką najwyższego poziomu lub odwołanie do kontrolki cyklicznej spowodowałoby dodanie tej kontrolki do kolekcji kontrolek.

ArgumentException

Obiekt przypisany do parametru value nie jest obiektem Control.

Przykłady

Poniższy przykład kodu dodaje element Control do Control.ControlCollection klasy Panelpochodnej . Przykład wymaga utworzenia kontrolki Panel i kontrolki Button na obiekcie Form. Po kliknięciu TextBox przycisku do panelu zostanie dodana kontrolka 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

Uwagi

Metoda Add umożliwia dodawanie Control obiektów na końcu kolekcji kontrolek.

Możesz również dodać nowe Control obiekty do kolekcji przy użyciu AddRange metody .

Aby usunąć Control wcześniej dodany element, użyj Removemetod , RemoveAtlub Clear .

Uwaga

Element Control można przypisać tylko do jednego Control.ControlCollection naraz. Control Jeśli element jest już elementem podrzędnym innej kontrolki, zostanie on usunięty z tej kontrolki, zanim zostanie dodany do innej kontrolki.

Uwagi dotyczące dziedziczenia

Podczas zastępowania Add(Control) w klasie pochodnej należy wywołać metodę klasy Add(Control) bazowej, aby upewnić się, że kontrolka jest dodawana do kolekcji.

Zobacz też

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