TabPage.TabPageControlCollection.Add(Control) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

TabPage.TabPageControlCollection.cs

Adds a control to the collection.

public:
 override void Add(System::Windows::Forms::Control ^ value);

public override void Add (System.Windows.Forms.Control? value);

override this.Add : System.Windows.Forms.Control -> unit

Public Overrides Sub Add (value As Control)

Parameters

value

Control

The control to add.

Exceptions

ArgumentException

The specified control is a TabPage.

Examples

The following code example creates a TabControl with one TabPage. This example uses the Add method to add a single control, button1, to the tabPage1. The Controls property is used to get the tabPage1 controls collection to add controls to the collection.

using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
   TabControl^ tabControl1;
   TabPage^ tabPage1;
   Button^ button1;

public:
   Form1()
   {
      this->tabControl1 = gcnew TabControl;
      this->tabPage1 = gcnew TabPage;
      this->button1 = gcnew Button;
      this->tabControl1->TabPages->Add( tabPage1 );
      this->tabControl1->Location = Point(25,25);
      this->tabControl1->Size = System::Drawing::Size( 250, 250 );
      
      // Gets the controls collection for tabPage1.
      // Adds button1 to this collection.
      this->tabPage1->Controls->Add( button1 );
      this->button1->Text = "button1";
      this->button1->Location = Point(25,25);
      this->ClientSize = System::Drawing::Size( 300, 300 );
      this->Controls->Add( tabControl1 );
   }

};

int main()
{
   Application::Run( gcnew Form1 );
}

using System.Drawing;
using System.Windows.Forms;

public class Form1 : Form
{
    private TabControl tabControl1;
    private TabPage tabPage1;
    private Button button1;

    public Form1()
    {
        this.tabControl1 = new TabControl();
        this.tabPage1 = new TabPage();
        this.button1 = new Button();

        this.tabControl1.TabPages.Add(tabPage1);
        this.tabControl1.Location = new Point(25, 25);
        this.tabControl1.Size = new Size(250, 250);

        // Gets the controls collection for tabPage1.
        // Adds button1 to this collection.
        this.tabPage1.Controls.Add(button1);

        this.button1.Text = "button1";
        this.button1.Location = new Point(25, 25);

        this.ClientSize = new Size(300, 300);
        this.Controls.Add(tabControl1);
    }

    static void Main() 
    {
        Application.Run(new Form1());
    }
}

Imports System.Drawing
Imports System.Windows.Forms

Public Class Form1
    Inherits Form
    Private tabControl1 As TabControl
    Private tabPage1 As TabPage
    Private button1 As Button

    Public Sub New()
        Me.tabControl1 = New TabControl()
        Me.tabPage1 = New TabPage()
        Me.button1 = New Button()

        Me.tabControl1.TabPages.Add(tabPage1)
        Me.tabControl1.Location = New Point(25, 25)
        Me.tabControl1.Size = New Size(250, 250)

        ' Gets the controls collection for tabPage1.
        ' Adds button1 to this collection.
        Me.tabPage1.Controls.Add(button1)

        Me.button1.Text = "button1"
        Me.button1.Location = New Point(25, 25)

        Me.ClientSize = New Size(300, 300)
        Me.Controls.Add(tabControl1)
    End Sub

    Shared Sub Main()
        Application.Run(New Form1())
    End Sub
End Class

Remarks

The specified control is added to the end of the collection. If the control is already a child of another control, it is removed from the other control.