Export (0) Print
Expand All

Form::ControlCollection::Add Method

Adds a control to the form.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
virtual void Add(
	Control^ value
) override

Parameters

value
Type: System.Windows.Forms::Control

The Control to add to the form.

ExceptionCondition
Exception

A multiple document interface (MDI) parent form cannot have controls added to it.

You can use this method to add controls to the form. If you want to add a group of already created controls to the form, use the Control::ControlCollection::AddRange method of the Control::ControlCollection class.

The following code example adds a TextBox and Label control to the control collection of a form. The example requires that a form has been created and named Form1.

public:
   void AddMyControls()
   {
      TextBox^ textBox1 = gcnew TextBox;
      Label^ label1 = gcnew Label;

      // Initialize the controls and their bounds.
      label1->Text = "First Name";
      label1->Location = Point( 48, 48 );
      label1->Size = System::Drawing::Size( 104, 16 );
      textBox1->Text = "";
      textBox1->Location = Point(48,64);
      textBox1->Size = System::Drawing::Size( 104, 16 );

      // Add the TextBox control to the form's control collection.
      Controls->Add( textBox1 );
      // Add the Label control to the form's control collection.
      Controls->Add( label1 );
   }

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft