ListViewItem.StateImageIndex プロパティ

定義

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

public:
 property int StateImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int StateImageIndex { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("ListView.StateImageList")]
public int StateImageIndex { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.StateImageIndex : int with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("ListView.StateImageList")>]
member this.StateImageIndex : int with get, set
Public Property StateImageIndex As Integer

プロパティ値

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

属性

例外

このプロパティに対して指定された値が -1 未満です。

- または -

このプロパティに対して指定された値が 14 を超えています。

注釈

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

注意

ImageListプロパティでStateImageList指定された には任意の数のイメージを含めることができますが、 StateImageIndex プロパティは 14 以下の任意の値に設定できますが、インデックス位置 0 と 1 のイメージのみが状態イメージとして表示されます。

適用対象

こちらもご覧ください