TabControl.TabPageCollection.Add Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adiciona uma página de guia à coleção.

Sobrecargas

Add(String)	Cria uma página de guia com o texto especificado e a adiciona à coleção.
Add(TabPage)	Adiciona um TabPage à coleção.
Add(String, String)	Cria uma página de guia com o texto e a chave especificados e os adiciona à coleção.
Add(String, String, Int32)	Cria uma página de guia com a chave, o texto e as imagens especificados e os adiciona à coleção.
Add(String, String, String)	Cria uma página de guia com a chave, o texto e as imagens especificados e os adiciona à coleção.

Add(String)

Cria uma página de guia com o texto especificado e a adiciona à coleção.

public:
 void Add(System::String ^ text);

public void Add (string text);

public void Add (string? text);

member this.Add : string -> unit

Public Sub Add (text As String)

Parâmetros

text

String

O texto a ser exibido na página da guia.

Comentários

O recém-criado TabPage é adicionado ao final da coleção.

Add(TabPage)

Adiciona um TabPage à coleção.

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

public void Add (System.Windows.Forms.TabPage value);

member this.Add : System.Windows.Forms.TabPage -> unit

Public Sub Add (value As TabPage)

Parâmetros

value

TabPage

O TabPage a ser adicionado.

Exceções

ArgumentNullException

O value especificado é null.

Exemplos

O exemplo de código a seguir cria um TabControl com um TabPage. Este exemplo usa o Add método para adicionar uma única página de guia ao controle tab tabControl1 . Observe que a TabPages propriedade é usada para obter a tabControl1 coleção de controles para adicionar a tabPage1 esta coleção.

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

public:
   Form1()
   {
      this->tabControl1 = gcnew TabControl;
      this->tabPage1 = gcnew TabPage;
      
      // Gets the controls collection for tabControl1.
      // Adds the tabPage1 to this collection.
      this->tabControl1->TabPages->Add( tabPage1 );
      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;

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

        // Gets the controls collection for tabControl1.
        // Adds the tabPage1 to this collection.
        this.tabControl1.TabPages.Add(tabPage1);

        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

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

        ' Gets the controls collection for tabControl1.
        ' Adds the tabPage1 to this collection.
        Me.tabControl1.TabPages.Add(tabPage1)

        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

Confira também

• AddRange(TabPage[])
• Remove(TabPage)
• RemoveAt(Int32)

Add(String, String)

Cria uma página de guia com o texto e a chave especificados e os adiciona à coleção.

public:
 void Add(System::String ^ key, System::String ^ text);

public void Add (string key, string text);

public void Add (string? key, string? text);

member this.Add : string * string -> unit

Public Sub Add (key As String, text As String)

Parâmetros

key

String

O nome da página da guia.

text

String

O texto a ser exibido na página da guia.

Comentários

A Name propriedade corresponde à chave de um TabPage no TabControl.TabPageCollection.

O recém-criado TabPage é adicionado ao final da coleção.

Add(String, String, Int32)

Cria uma página de guia com a chave, o texto e as imagens especificados e os adiciona à coleção.

public:
 void Add(System::String ^ key, System::String ^ text, int imageIndex);

public void Add (string key, string text, int imageIndex);

public void Add (string? key, string? text, int imageIndex);

member this.Add : string * string * int -> unit

Public Sub Add (key As String, text As String, imageIndex As Integer)

Parâmetros

key

String

O nome da página da guia.

text

String

O texto a ser exibido na página da guia.

imageIndex

Int32

O índice da imagem a ser exibida na página da guia.

Comentários

A Name propriedade corresponde à chave de um TabPage no TabControl.TabPageCollection.

O imageIndex parâmetro refere-se a uma imagem na ImageList propriedade do TabControl.

O recém-criado TabPage é adicionado ao final da coleção.

Add(String, String, String)

Cria uma página de guia com a chave, o texto e as imagens especificados e os adiciona à coleção.

public:
 void Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);

public void Add (string key, string text, string imageKey);

public void Add (string? key, string? text, string imageKey);

member this.Add : string * string * string -> unit

Public Sub Add (key As String, text As String, imageKey As String)

Parâmetros

key

String

O nome da página da guia.

text

String

O texto a ser exibido na página da guia.

imageKey

String

A chave da imagem a ser exibida na página da guia.

Comentários

A Name propriedade corresponde à chave de um TabPage no TabControl.TabPageCollection.

O imageKey parâmetro refere-se a uma imagem na ImageList propriedade do TabControl.

O recém-criado TabPage é adicionado ao final da coleção.