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 可以包含任意數目的影像，而且 屬性可以設定為等於或低於 14 的任何值，但 StateImageIndex 只有索引位置 0 和 1 的影像會顯示為狀態影像。

另請參閱

• StateImageList