ListViewItem.StateImageIndex 属性

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

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
<LocalizableAttribute(True)> _
Public Property StateImageIndex As Integer
用法
Dim instance As ListViewItem
Dim value As Integer

value = instance.StateImageIndex

instance.StateImageIndex = value

[LocalizableAttribute(true)] 
public int StateImageIndex { get; set; }

[LocalizableAttribute(true)] 
public:
property int StateImageIndex {
    int get ();
    void set (int value);
}

/** @property */
public int get_StateImageIndex ()

/** @property */
public void set_StateImageIndex (int value)

public function get StateImageIndex () : int

public function set StateImageIndex (value : int)

属性值

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

异常

异常类型	条件
ArgumentOutOfRangeException	为该属性指定的值小于 -1。 - 或 - 为该属性指定的值大于 14。

备注

此属性使您可以将索引指定到分配为相关联的 ListView 控件的 StateImageList 属性的 ImageList 中，其中存储了要在项的左边显示的状态图像。通常，状态图像是一个选中的或已清除的复选框，或是用于表示项的选中或未选中状态的图像。如果没有为 StateImageList 属性指定值，则 ListView 控件在其 CheckBoxes 属性设置为 true 时，显示默认的选中复选框或已清除复选框。

提示

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

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

ListViewItem 类
ListViewItem 成员
System.Windows.Forms 命名空间
ListView.StateImageList 属性