TabPage 类

表示 TabControl 中的单个选项卡页。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class TabPage
    Inherits Panel
用法
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

备注

TabPage 控件表示 TabControl 控件中的选项卡页。TabControl.TabPages 集合中选项卡页的顺序反映了 TabControl 控件中选项卡的顺序。若要更改控件中选项卡的顺序，则必须通过移除并在新索引位置插入选项卡来更改选项卡在集合中的位置。

TabPage 控件受其容器的限制，所以从 Control 基类继承的某些属性将不起作用，包括 Top、Height、Left、Width、Show 和 Hide。

TabControl 中的选项卡是 TabControl 的一部分，但不是单个 TabPage 控件的一部分。TabPage 类的成员（如 ForeColor 属性）只影响选项卡页的矩形工作区，而不影响选项卡。此外，TabPage 的 Hide 方法不会隐藏选项卡。若要隐藏选项卡，必须从 TabControl.TabPages 集合中移除 TabPage 控件。

提示

在 Microsoft .NET Framework 2.0 版 中，选项卡被视为选项卡页的一部分，用于确定 TabPage 的 Enter 和 Leave 事件何时发生。在 .NET Framework 的早期版本中，TabPage 的 Enter 和 Leave 事件在焦点进入或离开选项卡时不会发生，而只在焦点进入或离开选项卡页的矩形工作区时发生。

有关此控件如何响应 Focus 和 Select 方法的更多信息，请参见以下 Control 成员：CanFocus、CanSelect、Focused、ContainsFocus、Focus、Select。

提示

在选项卡页显示之前，将不会创建 TabPage 中包含的控件，并且不会激活这些控件中的任何数据绑定。

在 Microsoft .NET Framework 2.0 版 中，UseVisualStyleBackColor 属性可让您指示是否使用当前视觉样式呈现选项卡页的背景。仅当 UseVisualStyleBackColor 和 Application.RenderWithVisualStyles 属性值都为 true 并且父 TabControl 的 Appearance 属性为 Normal 时，才会发生此情况。否则，背景以正常方式绘制。

示例

下面的代码示例创建一个包含一个 TabPage 的 TabControl。

在此示例中使用 System.Drawing 和 System.Windows.Forms 命名空间。

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

继承层次结构

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

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 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

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

TabPage 成员
System.Windows.Forms 命名空间
TabControl 类
TabPage 类
TabControl.TabPages 属性