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属性引用由包含该ColumnHeader属性的图像的ListView索引SmallImageList。 如果没有SmallImageList在包含ListView项上设置属性，则ImageIndex返回 -1。 列中显示的图像通常用于指示列中项的状态。

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

ImageList如果属性值更改为null，则ImageIndex属性将返回其默认值 -1。 但是，分配 ImageIndex 的值在内部保留，并在将另一个 ImageList 对象分配给 ImageList 该属性时使用。 如果分配给该属性的新ImageList属性的ImageList.ImageCollection.Count属性值小于或等于分配给ImageIndex属性的值减去 1 (，则该属性值将调整为小于属性值的 1 个) ImageIndex。Count ImageList 例如，请考虑一个按钮控件，该 ImageList 控件具有三个图像，其 ImageIndex 属性设置为 2。 如果只有两个 ImageList 图像的新图像分配给该按钮，该值 ImageIndex 将更改为 1。