共用方式為


ListViewItem.StateImageIndex 屬性

定義

取得或設定為項目顯示之狀態影像的索引 (例如已選取或已清除核取方塊的影像,表示項目的狀態)。

public:
 property int StateImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int StateImageIndex { get; set; }
[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.ImageIndexConverter))>]
member this.StateImageIndex : int with 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

屬性值

ImageList 中為項目顯示之狀態影像的以零起始索引。

屬性

例外狀況

這個屬性的指定值小於 -1。

-或-

這個屬性的指定值大於 14。

備註

這個屬性可讓您將索引 ImageList 指定到指派給 StateImageList 相關聯 ListView 控制項的 屬性,其中要顯示在專案左邊的狀態影像會儲存。 一般而言,狀態影像是已選取或清除的核取方塊,或是要代表專案選取或清除狀態的影像。 如果未為 StateImageList 屬性指定任何值,當 ListView 控制項的 屬性設定 true 為 時 CheckBoxes ,控制項會顯示預設選取或清除的核取方塊。

注意

雖然 屬性 ImageList 中指定的 StateImageList 可以包含任意數目的影像,而且 屬性可以設定為等於或低於 14 的任何值,但 StateImageIndex 只有索引位置 0 和 1 的影像會顯示為狀態影像。

適用於

另請參閱