Control.ControlCollection.Add(Control) Метод

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Добавляет указанный элемент управления в коллекцию элементов управления.

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)

Параметры

value: Control

Объект Control, добавляемый в коллекцию элементов управления.

Исключения

Exception

Указанный элемент управления — элемент управления верхнего уровня, или появляется циклическая ссылка на элемент управления, если этот элемент управления был добавлен в коллекцию элементов управления.

ArgumentException

Объект, присвоенный параметру value, не представляет собой элемент управления Control.

Примеры

В следующем примере кода добавляется Control в Control.ControlCollection производный класс Panel. В этом примере требуется создать Panel элемент управления и Button элемент управления для элемента Formуправления . При нажатии TextBox кнопки элемент управления добавляется в панель 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

A Control может быть назначено только по одному Control.ControlCollection за раз. Если элемент Control управления уже является дочерним элементом другого элемента управления, он удаляется из этого элемента управления, прежде чем он будет добавлен в другой элемент управления.

Примечания для тех, кто наследует этот метод

При переопределении Add(Control) в производном классе обязательно вызовите метод базового класса Add(Control) , чтобы убедиться, что элемент управления добавлен в коллекцию.

Применяется к