ColumnHeader.ImageIndex プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ColumnHeader に表示されるイメージのインデックスを取得または設定します。
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.ImageIndexConverter))>]
member this.ImageIndex : int with get, setPublic Property ImageIndex As Integerプロパティ値
ColumnHeader に表示されるイメージのインデックス。
- 属性
例外
value が -1 未満です。
注釈
このプロパティは ImageIndex 、. を含むイメージのプロパティで SmallImageList 指定されたイメージの ListView インデックスを ColumnHeader参照します。 このプロパティはImageIndex、格納ListViewされているオブジェクトに設定がないSmallImageList場合、-1 を返します。 列に表示される画像は、通常、列内の項目の状態を示すために使用されます。
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 に変わります。