ColumnHeader.ImageIndex プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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, set

Public Property ImageIndex As Integer

プロパティ値

Int32

ColumnHeader に表示されるイメージのインデックス。

属性

TypeConverterAttribute

例外

ArgumentOutOfRangeException

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 に変わります。