ListViewItem.StateImageIndex 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置为该项显示的状态图像（指示项的状态的图像，例如，选中的复选框或已清除的复选框）的索引。

public:
 property int StateImageIndex { int get(); void set(int value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("ListView.StateImageList")]
public int StateImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("ListView.StateImageList")>]
member this.StateImageIndex : int with get, set

Public Property StateImageIndex As Integer

属性值

Int32

ImageList 中为该项显示的状态图像的从零开始的索引。

属性

TypeConverterAttribute RelatedImageListAttribute

例外

ArgumentOutOfRangeException

为该属性指定的值小于 -1。

- 或 -

为该属性指定的值大于 14。

注解

此属性允许将索引指定到 ImageList 分配给 StateImageList 关联 ListView 控件的 属性的 中，其中存储了要显示在项左侧的状态图像。 通常，状态图像是一个选中或已清除的复选框，或者是一个用于表示项目的选定或清除状态的图像。 如果未为 StateImageList 属性指定任何值，当控件的 ListView 属性设置为 true时CheckBoxes，控件将显示默认的选中或清除复选框。

注意

ImageList尽管 属性中指定的 StateImageList 可以包含任意数量的图像，并且 StateImageIndex 属性可以设置为等于或小于 14 的任何值，但只有索引位置为 0 和 1 的图像才会显示为状态图像。

另请参阅

• StateImageList