TabPage-Klasse

Stellt eine einzelne Registerkarte in einem TabControl dar.

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

Syntax

'Declaration
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class TabPage
    Inherits Panel
'Usage
Dim instance As TabPage

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class TabPage : Panel

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class TabPage : public Panel

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class TabPage extends Panel

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class TabPage extends Panel

Hinweise

TabPage-Steuerelemente stellen die Registerkarten in einem TabControl-Steuerelement dar. Die Reihenfolge der Registerkarten in der TabControl.TabPages-Auflistung entspricht der Reihenfolge der Registerkarten im TabControl-Steuerelement. Um die Reihenfolge der Registerkarten im Steuerelement zu ändern, müssen Sie deren Positionen in der Auflistung ändern, indem Sie sie entfernen und an einem neuen Index einfügen.

Da TabPage-Steuerelemente durch ihren Container beschränkt sind, wirken sich einige der von der Control-Basisklasse vererbten Eigenschaften nicht aus, z. B. die Top-Eigenschaft, die Height-Eigenschaft, die Left-Eigenschaft, die Width-Eigenschaft, die Show-Eigenschaft und die Hide-Eigenschaft.

Die Registerkarten in einem TabControl sind Teil des TabControl, aber nicht Teil der einzelnen TabPage-Steuerelemente. Member der TabPage-Klasse, z. B. die ForeColor-Eigenschaft, haben nur Auswirkungen auf das Clientrechteck der Registerkarte, aber nicht auf die Register. Die Hide-Methode der TabPage blendet die Registerkarte außerdem nicht aus. Zum Ausblenden der Registerkarte müssen Sie das TabPage-Steuerelement aus der TabControl.TabPages-Auflistung entfernen.

Hinweis

In Microsoft .NET Framework, Version 2.0 wird das Register als Teil der Registerkarte betrachtet, wenn bestimmt wird, wann das Enter-Ereignis und das Leave-Ereignis der TabPage eintreten. In älteren Versionen von .NET Framework treten das Enter-Ereignis und das Leave-Ereignis der TabPage nicht ein, wenn der Fokus in das Register eintritt oder dieses verlässt, sondern nur dann, wenn der Fokus in das Clientrechteck der Registerkarte eintritt oder dieses verlässt.

Weitere Informationen über die Reaktion dieses Steuerelements auf die Focus-Methode und die Select-Methode finden Sie unter den folgenden Control-Membern: CanFocus, CanSelect, Focused, ContainsFocus, Focus, Select.

Hinweis

In einer TabPage enthaltene Steuerelemente werden erst dann erstellt, wenn die Registerkarte angezeigt wird, und Datenbindungen in diesen Steuerelementen werden erst beim Anzeigen der Registerkarte aktiviert.

In Microsoft .NET Framework, Version 2.0 kann mit der UseVisualStyleBackColor-Eigenschaft angegeben werden, ob der Hintergrund der Registerkarte mit dem aktuellen visuellen Stil gerendert werden soll. Dies geschieht nur, wenn sowohl der UseVisualStyleBackColor-Eigenschaftenwert als auch der Application.RenderWithVisualStyles-Eigenschaftenwert true sind und die Appearance-Eigenschaft des übergeordneten TabControl den Wert Normal besitzt. Andernfalls wird der Hintergrund normal gezeichnet.

Beispiel

Im folgenden Codebeispiel wird ein TabControl mit einer TabPage erstellt.

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

    ' Declares tabPage1 as a TabPage type.
    Private tabPage1 As System.Windows.Forms.TabPage

    Private Sub MyTabs()
        Me.tabControl1 = New TabControl()

        ' Invokes the TabPage() constructor to create the tabPage1.
        Me.tabPage1 = New System.Windows.Forms.TabPage()

        Me.tabControl1.Controls.AddRange(New Control() {Me.tabPage1})
        Me.tabControl1.Location = New Point(25, 25)
        Me.tabControl1.Size = New Size(250, 250)

        Me.ClientSize = 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;

    // Declares tabPage1 as a TabPage type.
    private System.Windows.Forms.TabPage tabPage1;

    private void MyTabs()
    {
        this.tabControl1 = new TabControl();

        // Invokes the TabPage() constructor to create the tabPage1.
        this.tabPage1 = new System.Windows.Forms.TabPage();

        this.tabControl1.Controls.AddRange(new Control[] {
            this.tabPage1});
        this.tabControl1.Location = new Point(25, 25);
        this.tabControl1.Size = new Size(250, 250);

        this.ClientSize = 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;

   // Declares tabPage1 as a TabPage type.
   System::Windows::Forms::TabPage^ tabPage1;
   void MyTabs()
   {
      this->tabControl1 = gcnew TabControl;
      
      // Invokes the TabPage() constructor to create the tabPage1.
      this->tabPage1 = gcnew System::Windows::Forms::TabPage;
      array<Control^>^tabControls = {this->tabPage1};
      this->tabControl1->Controls->AddRange( tabControls );
      this->tabControl1->Location = Point(25,25);
      this->tabControl1->Size = System::Drawing::Size( 250, 250 );
      this->ClientSize = 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;

    // Declares tabPage1 as a TabPage type.
    private System.Windows.Forms.TabPage tabPage1;

    private void MyTabs()
    {
        this.tabControl1 = new TabControl();
        // Invokes the TabPage() constructor to create the tabPage1.
        this.tabPage1 = new System.Windows.Forms.TabPage();

        this.tabControl1.get_Controls().AddRange(new Control[] {
            this.tabPage1 });
        this.tabControl1.set_Location(new Point(25, 25));
        this.tabControl1.set_Size(new Size(250, 250));

        this.set_ClientSize(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

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
         System.Windows.Forms.ScrollableControl
           System.Windows.Forms.Panel
            System.Windows.Forms.TabPage

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

TabPage-Member
System.Windows.Forms-Namespace
TabControl-Klasse
TabPage-Klasse
TabControl.TabPages-Eigenschaft