TabControl.SelectedTab Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: TabControl.cs

Source:: TabControl.cs

Source:: TabControl.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the currently selected tab page.

public:
 property System::Windows::Forms::TabPage ^ SelectedTab { System::Windows::Forms::TabPage ^ get(); void set(System::Windows::Forms::TabPage ^ value); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.TabPage SelectedTab { get; set; }

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.TabPage? SelectedTab { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectedTab : System.Windows.Forms.TabPage with get, set

Public Property SelectedTab As TabPage

Property Value

TabPage

A TabPage that represents the selected tab page. If no tab page is selected, the value is null.

Attributes: BrowsableAttribute

Examples

The following code example creates a TabControl with two TabPage objects. The SelectedTab property sets tabPage2 as the currently selected tab page.

using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
   TabControl^ tabControl1;
   TabPage^ tabPage1;
   TabPage^ tabPage2;
   void MyTabs()
   {
      this->tabControl1 = gcnew TabControl;
      this->tabPage1 = gcnew TabPage;
      this->tabPage2 = gcnew TabPage;
      array<Control^>^temp0 = {this->tabPage1,this->tabPage2};
      this->tabControl1->Controls->AddRange( temp0 );
      this->tabControl1->Padding = Point(15,10);
      this->tabControl1->Location = Point(35,25);
      this->tabControl1->Size = System::Drawing::Size( 220, 220 );
      
      // Selects tabPage2 using SelectedTab.
      this->tabControl1->SelectedTab = tabPage2;
      this->tabPage1->Text = "tabPage1";
      this->tabPage2->Text = "tabPage2";
      this->Size = System::Drawing::Size( 300, 300 );
      array<Control^>^temp1 = {this->tabControl1};
      this->Controls->AddRange( temp1 );
   }


public:
   Form1()
   {
      MyTabs();
   }

};

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 void MyTabs()
    {
        this.tabControl1 = new TabControl();
        this.tabPage1 = new TabPage();
        this.tabPage2 = new TabPage();

        this.tabControl1.Controls.AddRange(new Control[] {
            this.tabPage1,
            this.tabPage2});
        this.tabControl1.Padding = new Point(15, 10);
        this.tabControl1.Location = new Point(35, 25);
        this.tabControl1.Size = new Size(220, 220);

        // Selects tabPage2 using SelectedTab.
        this.tabControl1.SelectedTab = tabPage2;
    
        this.tabPage1.Text = "tabPage1";
        this.tabPage2.Text = "tabPage2";

        this.Size = new Size(300, 300);
        this.Controls.AddRange(new Control[] {
            this.tabControl1});
    }
    
    public Form1()
    {
        MyTabs();
    }

    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 Sub MyTabs()
        Me.tabControl1 = New TabControl()
        Me.tabPage1 = New TabPage()
        Me.tabPage2 = New TabPage()

        Me.tabControl1.Controls.AddRange(New Control() {Me.tabPage1, Me.tabPage2})
        Me.tabControl1.Padding = New Point(15, 10)
        Me.tabControl1.Location = New Point(35, 25)
        Me.tabControl1.Size = New Size(220, 220)

        ' Selects tabPage2 using SelectedTab.
        Me.tabControl1.SelectedTab = tabPage2

        Me.tabPage1.Text = "tabPage1"
        Me.tabPage2.Text = "tabPage2"

        Me.Size = New Size(300, 300)
        Me.Controls.AddRange(New Control() {Me.tabControl1})
    End Sub

    Public Sub New()
        MyTabs()
    End Sub

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

Remarks

The tab page must be in the TabPages collection to make it the current tab page.

Applies to

Jaa