ListViewItem.ImageIndex プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
項目に対して表示されるイメージのインデックスを取得または設定します。
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, setPublic Property ImageIndex As Integerプロパティ値
項目に対して表示される ImageList のイメージの 0 から始まるインデックス。 既定値は -1 です。
- 属性
例外
value が -1 未満です。
注釈
このプロパティの値は、ImageList プロパティの値によって異なります。 項目に関連付けられているコントロールのプロパティのView現在のListView値に応じて、項目で使用される値は、ImageListコントロールのListViewプロパティまたはSmallImageListプロパティでLargeImageList指定された値になります。 プロパティがView設定LargeIconされている場合は、プロパティでLargeImageList指定されたImageListプロパティが使用されます。それ以外の場合は、ImageListプロパティでSmallImageList指定された値が使用されます。 プロパティで指定された ImageList イメージで定義されているイメージは、 SmallImageList プロパティで指定されたイメージ ImageList と同じインデックス位置を LargeImageList 持つ必要があります。 両方ImageListのコントロールのインデックス位置が同じ場合は、プロパティに 1 つのインデックス値をImageIndex設定できます。コントロールのプロパティの値に関係なく、適切なイメージがViewListView表示されます。
ImageKey は ImageIndex 相互に排他的であり、一方が設定されている場合、もう一方は無効な値に設定され、無視されます。 プロパティを ImageKey 設定すると、 ImageIndex プロパティは自動的に -1 に設定されます。 または、プロパティを ImageIndex 設定すると、 ImageKey 自動的に空の文字列 ("") に設定されます。
プロパティの値が ImageList 変更された null場合、 ImageIndex プロパティは既定値 -1 を返します。 ただし、割り当てられた ImageIndex 値は内部的に保持され、別 ImageList のオブジェクトがプロパティに ImageList 割り当てられるときに使用されます。 プロパティにImageList割り当てられた新しいImageListプロパティ値が、プロパティImageList.ImageCollection.Countに割り当てられたImageIndex値から 1 を引いた値以下である場合 (コレクションが 0 から始まるインデックスであることを考慮するため)、ImageIndexプロパティ値はプロパティ値よりCount小さい値に調整されます。
たとえば、3 つの画像がありImageIndex、そのプロパティが ImageList 2 に設定されているボタン コントロールを考えてみましょう。 ボタンに 2 つのイメージしか割り当てされていない新しい ImageList イメージが割り当てられている場合、値は ImageIndex 1 に変わります。