ListViewItem.ImageIndex プロパティ

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

ListViewItem.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 ListViewItem
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)

プロパティ値
項目に対して表示される ImageList のイメージの 0 から始まるインデックス番号。既定値は -1 です。

例外

例外の種類	条件
ArgumentException	指定された値が -1 未満です。

解説

このプロパティの値は、ImageList プロパティの値によって異なります。項目に関連付けられている ListView コントロールの View プロパティの現在の値によって、項目で使用される ImageList は、LargeImageList プロパティまたは ListView コントロールの SmallImageList プロパティに指定されている値になります。View プロパティが LargeIcon に設定されている場合は、LargeImageList プロパティに指定されている ImageList が使用されます。それ以外の場合は、SmallImageList プロパティに指定されている ImageList が使用されます。SmallImageList に指定されている ImageList で定義されているイメージのインデックス位置は、LargeImageList プロパティに指定されている ImageList のイメージと同じにする必要があります。双方の ImageList コントロールでインデックス位置が同じであると、ImageIndex プロパティに対して単一のインデックス値を設定でき、ListView コントロールの View プロパティの値にかかわらず、適切なイメージが表示されます。ImageKey プロパティと ImageIndex プロパティは同時には指定できません。つまり、一方が設定されている場合、もう一方は無視されます。具体的には、ImageKey プロパティを設定すると、ImageIndex プロパティは自動的に -1 に設定されます。反対に、ImageIndex プロパティを設定すると、ImageKey は自動的に空の文字列 ("") に設定されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
ListViewItem クラス
ListViewItem メンバ
System.Windows.Forms 名前空間
ListView.View プロパティ
ListView.SmallImageList プロパティ
ListView.LargeImageList プロパティ