TabPage.TabPageControlCollection.Add(Control) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega un control a la colección.

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

Control que se va a agregar.

Excepciones

ArgumentException

El control especificado es TabPage.

Ejemplos

En el ejemplo de código siguiente se crea un objeto TabControl con uno TabPage. En este ejemplo se usa el Add método para agregar un único control, button1, a .tabPage1 La Controls propiedad se usa para obtener la tabPage1 colección controls para agregar controles a la colección.

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

Comentarios

El control especificado se agrega al final de la colección. Si el control ya es un elemento secundario de otro control, se quita del otro control.