ListViewItem.ImageIndex プロパティ

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

アイテムに表示されるイメージのインデックスを取得または設定します。

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

プロパティ値

Int32

アイテムに対して表示される ImageList 内のイメージの 0 から始まるインデックス。 既定値は -1 です。

属性
TypeConverterAttribute

例外

ArgumentOutOfRangeException

value が -1 未満です。

注釈

このプロパティの値は、 ImageList プロパティの値によって異なります。 アイテムに関連付けられているView コントロールのListView プロパティの現在の値に応じて、アイテムで使用されるImageListは、LargeImageList プロパティまたはSmallImageList コントロールのListView プロパティで指定できます。 View プロパティが LargeIcon に設定されている場合は、ImageList プロパティで指定されたLargeImageListが使用されます。それ以外の場合は、ImageList プロパティで指定されたSmallImageListが使用されます。 ImageList プロパティで指定されたSmallImageListで定義されたイメージは、ImageList プロパティで指定されたLargeImageList内のイメージと同じインデックス位置を持つ必要があります。 両方のImageList コントロールのインデックス位置が同じ場合は、ImageIndex プロパティに 1 つのインデックス値を設定できます。View コントロールのListView プロパティの値に関係なく、適切なイメージが表示されます。

ImageKey と ImageIndex は相互に排他的です。つまり、一方が設定されている場合、もう一方は無効な値に設定され、無視されます。 ImageKey プロパティを設定すると、ImageIndex プロパティは自動的に -1 に設定されます。 または、 ImageIndex プロパティを設定すると、 ImageKey は自動的に空の文字列 ("") に設定されます。

ImageList プロパティの値が null に変更された場合、ImageIndex プロパティは既定値の -1 を返します。 ただし、割り当てられた ImageIndex 値は内部的に保持され、別の ImageList オブジェクトが ImageList プロパティに割り当てられるときに使用されます。 ImageList プロパティに割り当てられた新しいImageListに、ImageList.ImageCollection.Count プロパティに割り当てられた値から 1 を引いた値 (コレクションが 0 から始まるインデックスを考慮するため) 以下のImageIndexプロパティ値がある場合、ImageIndex プロパティ値はCountプロパティ値より 1 小さい値に調整されます。 たとえば、 ImageList に 3 つの画像があり、 ImageIndex プロパティが 2 に設定されているボタン コントロールを考えてみます。 2 つのイメージしかない新しい ImageList がボタンに割り当てられている場合、 ImageIndex 値は 1 に変わります。

適用対象

こちらもご覧ください