TabControl.TabPageCollection.AddRange(TabPage[]) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adds a set of tab pages to the collection.

public:
 void AddRange(cli::array <System::Windows::Forms::TabPage ^> ^ pages);

public void AddRange (System.Windows.Forms.TabPage[] pages);

member this.AddRange : System.Windows.Forms.TabPage[] -> unit

Public Sub AddRange (pages As TabPage())

Parameters

pages

TabPage[]

An array of type TabPage that contains the tab pages to add.

Exceptions

ArgumentNullException

The value of pages equals null.

Examples

The following code example creates a TabControl with three TabPage. This example uses the AddRange method to add an array of tab pages to the tabControl1 tab control. Notice that the TabPages property gets the tabControl1 controls collection, in order to add the array of tab pages to this collection.

Use the System.Drawing and System.Windows.Forms namespaces for this collection.

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

public:
   Form1()
   {
      this->tabControl1 = gcnew TabControl;
      this->tabPage1 = gcnew TabPage;
      this->tabPage2 = gcnew TabPage;
      this->tabPage3 = gcnew TabPage;
      array<TabPage^>^tabPages = {tabPage1,tabPage2,tabPage3};
      
      // Gets the controls collection for tabControl1.
      // Adds an array of tab pages to this collection.
      this->tabControl1->Controls->AddRange( tabPages );
      this->tabControl1->Location = Point(25,25);
      this->tabControl1->Size = System::Drawing::Size( 250, 250 );
      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 TabPage tabPage2;
    private TabPage tabPage3;

    public Form1()
    {
        this.tabControl1 = new TabControl();
        this.tabPage1 = new TabPage();
        this.tabPage2 = new TabPage();
        this.tabPage3 = new TabPage();

        // Gets the controls collection for tabControl1.
        // Adds an array of tab pages to this collection.
        this.tabControl1.Controls.AddRange(new TabPage[] {
            tabPage1, tabPage2, tabPage3});

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

        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 tabPage2 As TabPage
    Private tabPage3 As TabPage

    Public Sub New()
        Me.tabControl1 = New TabControl()
        Me.tabPage1 = New TabPage()
        Me.tabPage2 = New TabPage()
        Me.tabPage3 = New TabPage()

        ' Gets the controls collection for tabControl1.
        ' Adds an array of tab pages to this collection.
        Me.tabControl1.Controls.AddRange(New TabPage() {tabPage1, tabPage2, tabPage3})

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

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

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

See also

• Add(TabPage)
• Remove(TabPage)
• RemoveAt(Int32)
• TabPage