ListViewItem.StateImageIndex プロパティ

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

Public Property StateImageIndex As Integer
[C#]
public int StateImageIndex {get; set;}
[C++]
public: __property int get_StateImageIndex();public: __property void set_StateImageIndex(int);
[JScript]
public function get StateImageIndex() : int;public function set StateImageIndex(int);

プロパティ値

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

例外

解説

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

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

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

ListViewItem クラス | ListViewItem メンバ | System.Windows.Forms 名前空間 | ListView.StateImageList