ListViewItem.StateImageIndex プロパティ

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

ListViewItem.StateImageIndex プロパティ

項目に対して表示される、状態のイメージ (オンまたはオフのチェック ボックスなど、項目の状態を示すイメージ) のインデックスを取得または設定します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As ListViewItem
Dim value As Integer

value = instance.StateImageIndex

instance.StateImageIndex = value

C#

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

C++

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

J#

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

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

JScript

public function get StateImageIndex
 () : int

public function set StateImageIndex
 (value : int)

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

例外

例外の種類	条件
ArgumentOutOfRangeException	このプロパティに対して指定された値が -1 未満です。 または このプロパティに対して指定された値が 14 を超えています。

解説

このプロパティを使用すると、関連付けられている ListView コントロールの StateImageList プロパティに代入されている ImageList にインデックスを指定できます。ここには、項目の左側に表示される状態のイメージが格納されます。通常、状態のイメージとは、オンまたはオフのチェック ボックス、または項目の選択状態または選択解除状態を表すために使用するイメージです。StateImageList プロパティに対して指定されている値がない場合、ListView コントロールの CheckBoxes プロパティが true に設定されているときは、コントロールによって既定のオンまたはオフのチェック ボックスが表示されます。

メモ
StateImageList プロパティに指定されている ImageList にはイメージをいくつでも格納でき、StateImageIndex プロパティは 14 以下の値に設定できますが、インデックス位置 0 および 1 のイメージだけが状態のイメージとして表示されます。

プラットフォーム

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

参照

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