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 コントロールはコンテナによる制約を受けます。そのため、Top、Height、Left、Width、Show、Hide など、Control 基本クラスから継承されたプロパティの一部は無効になります。

TabControl のタブは TabControl の一部ですが、個別の TabPage コントロールの一部ではありません。ForeColor プロパティなどの TabPage クラスのメンバは、タブ ページのクライアントの四角形にだけ影響し、タブには影響しません。さらに、TabPage の Hide メソッドを使用してもタブは非表示になりません。タブを非表示にするには、TabPage コントロールを TabControl.TabPages コレクションから削除する必要があります。

注意

Microsoft .NET Framework version 2.0 では、タブは、TabPage の Enter イベントと Leave イベントがいつ発生するかを決定するタブ ページの一部であると見なされます。.NET Framework の以前のバージョンでは、TabPage の Enter イベントと Leave イベントは、タブにフォーカスが移るか離れた場合には発生せず、タブ ページのクライアントの四角形にフォーカスが移るか離れた場合にだけ発生していました。

Focus メソッドおよび Select メソッド対してこのコントロールが応答する方法の詳細については、CanFocus、CanSelect、Focused、ContainsFocus、Focus、Select の各 Control メンバのトピックを参照してください。

注意

TabPage に含まれるコントロールは、タブ ページが表示されるまで作成されません。また、これらのコントロール内のいずれのデータ バインディングも、タブ ページが表示されるまでアクティブになりません。

Microsoft .NET Framework version 2.0 では、UseVisualStyleBackColor プロパティを使用して、タブ ページの背景の描画に現在の visual スタイルを使用するかどうかを指定できます。これは、UseVisualStyleBackColor プロパティおよび Application.RenderWithVisualStyles プロパティの値がどちらも true で、親 TabControl の Appearance プロパティが Normal の場合にのみ発生します。それ以外の場合、背景は通常どおりに描画されます。

使用例

1 つの 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

スレッド セーフ

この型の public static (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 プロパティ