ColumnHeader.ImageIndex 属性

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

属性值

显示在 .. 中的 ColumnHeader图像的索引。

属性

TypeConverterAttribute

例外

注解

该ImageIndex属性引用由包含该ColumnHeader属性的属性指定的SmallImageList图像的ListView索引。 如果没有SmallImageList对包含ListView项设置，则此属性ImageIndex返回 -1。 列中显示的图像通常用于指示列中项的状态。

ImageKey 并且 ImageIndex 是互斥的，这意味着如果设置了一个，另一个则设置为无效值并忽略。 如果设置该 ImageKey 属性，则 ImageIndex 属性将自动设置为 -1。 或者，如果设置属性 ImageIndex ，则 ImageKey 会自动设置为空字符串（“）。

ImageList如果属性值更改为 null，则ImageIndex属性将返回其默认值 -1。 但是，分配 ImageIndex 的值在内部保留，并在将另一个 ImageList 对象分配给 ImageList 该属性时使用。 如果分配给ImageList该属性的新ImageList属性的ImageList.ImageCollection.Count属性值小于或等于分配给ImageIndex属性的值减一（要考虑到集合是从零开始的索引），则ImageIndex属性值将调整为小于属性值的Count一个。 例如，假设有三个图像且其属性设置为 2 的ImageIndex按钮控件ImageList。 如果只有两个 ImageList 图像的新图像分配给该按钮，该值 ImageIndex 将更改为 1。