The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
Form::ControlCollection::Add Method (Control^)
.NET Framework (current version)
Adds a control to the form.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Exception | Condition |
|---|---|
| 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
Available since 1.1
Available since 1.1
Show: