TabPage.ImageIndex プロパティ

.NET Framework クラス ライブラリ リファレンス

TabPage.ImageIndex プロパティ

このタブに表示されているイメージのインデックスを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property ImageIndex As
 Integer

Visual Basic (使用法)

Dim instance As TabPage
Dim value As Integer

value = instance.ImageIndex

instance.ImageIndex = value

C#

[LocalizableAttribute(true)] 
public int ImageIndex { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
property int ImageIndex {
    int get ();
    void set (int value);
}

J#

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

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

JScript

public function get ImageIndex
 () : int

public function set ImageIndex
 (value : int)

プロパティ値
タブに表示される TabControl.ImageList のイメージの 0 から始まるインデックス番号。既定値は -1 です。これはイメージがないことを示します。

例外

例外の種類	条件
ArgumentException	ImageIndex の値が -1 未満です。

解説

ImageIndex は、TabControl の関連付けられた ImageList 内のいずれかのイメージを示します。

使用例

1 つの TabPage がある TabControl を作成するコード例を次に示します。この例では、ImageIndex プロパティを使用して、myImages のどのイメージを tabPage1 のタブに表示するかを指定しています。

この例では、System.Drawing、System.ComponentModel、System.Windows.Forms、System.Resources の各名前空間を使用します。

Visual Basic

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
Imports System.Resources

Public Class Form1
    Inherits Form

    Public Sub New()
        Dim components = New Container()
        Dim resources As New
 ResourceManager(GetType(Form1))
        Dim tabControl1 As New
 TabControl()
        Dim tabPage1 As New
 TabPage()
        Dim myImages As New
 ImageList(components)

        tabControl1.Controls.Add(tabPage1)

        ' Displays images from myImages on the tabs of tabControl1.
        tabControl1.ImageList = myImages

        ' Specifies which image to display (on the tab of tabPage1)
 by its index.
        tabPage1.ImageIndex = 0

        tabPage1.Text = "tabPage1"

        myImages.ImageStream = CType(resources.GetObject("myImages.ImageStream"),
 ImageListStreamer)
        myImages.ColorDepth = ColorDepth.Depth8Bit
        myImages.ImageSize = New Size(16, 16)
        myImages.TransparentColor = Color.Transparent

        Me.Controls.Add(tabControl1)
    End Sub

    Shared Sub Main()
        Application.Run(New Form1())
    End Sub
End Class

C#

using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
using System.Resources;

public class Form1 : Form
{
    public Form1()
    {
        IContainer components = new Container();
        ResourceManager resources = new ResourceManager(typeof(Form1));
        TabControl tabControl1 = new TabControl();
        TabPage tabPage1 = new TabPage();
        ImageList myImages = new ImageList(components);

        tabControl1.Controls.Add(tabPage1);

        // Displays images from myImages on the tabs of tabControl1.
        tabControl1.ImageList = myImages;

        // Specifies which image to display (on the tab of tabPage1)
 by its index.
        tabPage1.ImageIndex = 0;

        tabPage1.Text = "tabPage1";

        myImages.ImageStream = ((ImageListStreamer)(resources.GetObject("myImages.ImageStream")));
        myImages.ColorDepth = ColorDepth.Depth8Bit;
        myImages.ImageSize = new Size(16, 16);
        myImages.TransparentColor = Color.Transparent;

        this.Controls.Add(tabControl1);
    }

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

C++

using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using namespace System::Resources;
public ref class Form1: public
 Form
{
public:
   Form1()
   {
      IContainer^ components = gcnew System::ComponentModel::Container;
      ResourceManager^ resources = gcnew ResourceManager( Form1::typeid );
      TabControl^ tabControl1 = gcnew TabControl;
      TabPage^ tabPage1 = gcnew TabPage;
      ImageList^ myImages = gcnew ImageList( components );
      tabControl1->Controls->Add( tabPage1 );
      
      // Displays images from myImages on the tabs of tabControl1.
      tabControl1->ImageList = myImages;
      
      // Specifies which image to display (on the tab of tabPage1) by
 its index.
      tabPage1->ImageIndex = 0;
      tabPage1->Text = "tabPage1";
      myImages->ImageStream = (dynamic_cast<ImageListStreamer^>(resources->GetObject(
 "myImages.ImageStream" )));
      myImages->ColorDepth = ColorDepth::Depth8Bit;
      myImages->ImageSize = System::Drawing::Size( 16, 16 );
      myImages->TransparentColor = Color::Transparent;
      this->Controls->Add( tabControl1 );
   }

};

int main()
{
   Application::Run( gcnew Form1 );
}

J#

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

public class Form1 extends Form
{
    public Form1()
    {
        IContainer components = new Container();
        ResourceManager resources = new ResourceManager(Form1.class.ToType());
        TabControl tabControl1 = new TabControl();
        TabPage tabPage1 = new TabPage();
        ImageList myImages = new ImageList(components);

        tabControl1.get_Controls().Add(tabPage1);
        // Displays images from myImages on the tabs of tabControl1.
        tabControl1.set_ImageList(myImages);
        // Specifies which image to display (on the tab of tabPage1)
 by its
        // index.
        tabPage1.set_ImageIndex(0);

        tabPage1.set_Text("tabPage1");

        myImages.set_ImageStream(((ImageListStreamer)(
            resources.GetObject("myImages.ImageStream"))));
        myImages.set_ColorDepth(ColorDepth.Depth8Bit);
        myImages.set_ImageSize(new Size(16, 16));
        myImages.set_TransparentColor(Color.get_Transparent());

        this.get_Controls().Add(tabControl1);
    } //Form1

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

プラットフォーム

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

参照

関連項目
TabPage クラス
TabPage メンバ
System.Windows.Forms 名前空間
TabControl.ImageList プロパティ