TabPage.TabPageControlCollection.Add(Control) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adiciona um controle à coleção.

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

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)

Parâmetros

value

Control

O controle a se adicionar.

Exceções

ArgumentException

O controle especificado é um TabPage.

Exemplos

O exemplo de código a seguir cria um TabControl com um TabPage. Este exemplo usa o Add método para adicionar um único controle, button1ao tabPage1. A Controls propriedade é usada para obter a tabPage1 coleção de controles para adicionar controles à coleção.

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

Comentários

O controle especificado é adicionado ao final da coleção. Se o controle já for filho de outro controle, ele será removido do outro controle.