通过

ListViewItem.ImageIndex 属性

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

获取或设置为该项显示的图像的索引。

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, set
Public Property ImageIndex As Integer

属性值

Int32

ImageList 中为该项显示的图像的从零开始的索引。 默认值为 -1。

属性
TypeConverterAttribute

例外

ArgumentOutOfRangeException

value 小于 -1。

注解

此属性的值取决于属性的值 ImageList 。 根据与项关联的控件属性的ListView当前值View，ImageList该项使用的可以是LargeImageList属性或SmallImageList控件的属性中指定的ListView值。 如果属性 View 设置为 LargeIcon， ImageList 则使用属性中指定的 LargeImageList 值;否则， ImageList 将使用属性 SmallImageList 中指定的属性。 在属性中指定的ImageListSmallImageList图像应具有与属性中指定的LargeImageList图像ImageList相同的索引位置。 如果两ImageList个控件的索引位置相同，则可以为ImageIndex属性设置单个索引值，并且无论控件的属性ListView的值View如何，都会显示相应的图像。

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。

适用于

另请参阅