通过

ListViewItem.ImageIndex 属性

  • 项目

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

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

语法

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

value = instance.ImageIndex

instance.ImageIndex = value

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

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

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

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

public function get ImageIndex () : int

public function set ImageIndex (value : int)

属性值

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

异常

异常类型 条件

ArgumentException

指定的值小于 -1。

备注

此属性的值取决于 ImageList 属性的值。根据与该项关联的 ListView 控件的 View 属性的当前值，由该项使用的 ImageList 可以是在 ListView 控件的 LargeImageList 属性或 SmallImageList 属性中指定的一个。如果 View 属性设置为 LargeIcon，则使用在 LargeImageList 属性中指定的 ImageList；否则，使用在 SmallImageList 属性中指定的 ImageList。在 SmallImageList 中的指定 ImageList 中定义的图像与 LargeImageList 属性中的指定 ImageList 中的图像应具有相同的索引位置。如果这两个 ImageList 控件的索引位置相同，您可以为 ImageIndex 属性设置单个索引值，并且将会显示适当的图像，而不考虑 ListView 控件的 View 属性的值。ImageKey 和 ImageIndex 属性互相排斥，这意味着如果设置了其中的一个属性，另一个属性将被忽略。而且，如果设置 ImageKey 属性，则会自动将 ImageIndex 属性设置为 -1。或者，如果设置 ImageIndex 属性，则会自动将 ImageKey 设置为空字符串 ("")。

平台

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

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

ListViewItem 类
ListViewItem 成员
System.Windows.Forms 命名空间
ListView.View 属性
ListView.SmallImageList 属性
ListView.LargeImageList 属性