TabControl::SelectedTab Property


Gets or sets the currently selected tab page.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

property TabPage^ SelectedTab {
	TabPage^ get();
	void set(TabPage^ value);

Property Value

Type: System.Windows.Forms::TabPage^

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

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

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

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

using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
   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 );



int main()
   Application::Run( gcnew Form1 );

.NET Framework
Available since 1.1
Return to top