TabControl.SelectedIndex Property

Gets or sets the index of the currently selected tab page.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public int SelectedIndex { get; set; }
/** @property */
public int get_SelectedIndex ()

/** @property */
public void set_SelectedIndex (int value)

public function get SelectedIndex () : int

public function set SelectedIndex (value : int)

Not applicable.

Property Value

The zero-based index of the currently selected tab page. The default is -1, which is also the value if no tab page is selected.

Exception typeCondition

ArgumentOutOfRangeException

The value is less than -1.

The following code example creates a TabControl with two TabPage objects. The SelectedIndex property sets tabPage2 as the currently selected tab page using its index value.

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

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 SelectedIndex.
        this.tabControl1.SelectedIndex = 1;
    
        this.tabPage1.Text = "myTabPage1";
        this.tabPage1.TabIndex = 0;

        this.tabPage2.Text = "myTabPage2";
        this.tabPage2.TabIndex = 1;

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

    static void Main() 
    {
        Application.Run(new Form1());
    }
}

import System.Drawing.*;
import System.Windows.Forms.*;

public class Form1 extends 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.get_Controls().AddRange(new Control[] { this.
            tabPage1, this.tabPage2 });
        this.tabControl1.set_Padding(new Point(15, 10));
        this.tabControl1.set_Location(new Point(35, 25));
        this.tabControl1.set_Size(new Size(220, 220));
        // Selects tabPage2 using SelectedIndex.
        this.tabControl1.set_SelectedIndex(1);
        this.tabPage1.set_Text("myTabPage1");
        this.tabPage1.set_TabIndex(0);
        this.tabPage2.set_Text("myTabPage2");
        this.tabPage2.set_TabIndex(1);
        this.set_Size(new Size(300, 300));
        this.get_Controls().AddRange(new Control[] { this.tabControl1 });
    } //MyTabs

    public Form1()
    {
        MyTabs();
    } //Form1

    public static void main(String[] args)
    {       
        Application.Run(new Form1());
    } //main
} //Form1

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Show: