TabControl.SelectedIndex-Eigenschaft

Ruft den Index der derzeit ausgewählten Registerkarte ab oder legt diesen fest.

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

Syntax

'Declaration
Public Property SelectedIndex As Integer
'Usage
Dim instance As TabControl
Dim value As Integer

value = instance.SelectedIndex

instance.SelectedIndex = value

public int SelectedIndex { get; set; }

public:
property int SelectedIndex {
    int get ();
    void set (int value);
}

/** @property */
public int get_SelectedIndex ()

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

public function get SelectedIndex () : int

public function set SelectedIndex (value : int)

Eigenschaftenwert

Der nullbasierte Index der derzeit ausgewählten Registerkarte. Der Standardwert ist -1 und gilt auch dann, wenn keine Registerkarte ausgewählt ist.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	Der Wert ist kleiner als -1.

Beispiel

Im folgenden Codebeispiel wird ein TabControl mit zwei TabPage-Objekten erstellt. Die SelectedIndex-Eigenschaft legt mit ihrem Indexwert tabPage2 als die aktuell ausgewählte Registerkarte fest.

Verwenden Sie für dieses Beispiel den System.Drawing-Namespace und den System.Windows.Forms-Namespace.

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 SelectedIndex.
        Me.tabControl1.SelectedIndex = 1

        Me.tabPage1.Text = "myTabPage1"
        Me.tabPage1.TabIndex = 0

        Me.tabPage2.Text = "myTabPage2"
        Me.tabPage2.TabIndex = 1

        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

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());
    }
}

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^>^tabControls = {this->tabPage1,this->tabPage2};
      this->tabControl1->Controls->AddRange( tabControls );
      this->tabControl1->Padding = Point(15,10);
      this->tabControl1->Location = Point(35,25);
      this->tabControl1->Size = System::Drawing::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 = System::Drawing::Size( 300, 300 );
      array<Control^>^formControls = {this->tabControl1};
      this->Controls->AddRange( formControls );
   }


public:
   Form1()
   {
      MyTabs();
   }

};

int main()
{
   Application::Run( gcnew 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

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TabControl-Klasse
TabControl-Member
System.Windows.Forms-Namespace
TabPage
DeselectTab
SelectTab
SelectedTab
Deselecting
Deselected
Selecting
Selected