ListViewItem.StateImageIndex Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia indeks obrazu stanu (obraz, taki jak zaznaczone lub wyczyszczone pole wyboru, które wskazuje stan elementu), które jest wyświetlane dla elementu.

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

Wartość właściwości

Int32

Indeks stanu na podstawie zera w ImageList wyświetlonym elemencie.

Atrybuty

TypeConverterAttribute RelatedImageListAttribute

Wyjątki

ArgumentOutOfRangeException

Wartość określona dla tej właściwości jest mniejsza niż -1.

-lub-

Wartość określona dla tej właściwości jest większa niż 14.

Uwagi

Ta właściwość umożliwia określenie indeksu do ImageList przypisanej do StateImageList właściwości skojarzonej ListView kontrolki, gdzie przechowywane są obrazy stanu wyświetlane po lewej stronie elementu. Zazwyczaj obraz stanu jest zaznaczonym lub wyczyszczonem polem wyboru albo obrazem, który ma reprezentować wybrane lub wyczyszczone stany elementu. Jeśli dla właściwości nie określono StateImageList żadnej wartości, ListView kontrolka wyświetla domyślne pole wyboru zaznaczone lub wyczyszczone, gdy CheckBoxes właściwość kontrolki jest ustawiona na true.

Uwaga

Chociaż określona ImageList we StateImageList właściwości może zawierać dowolną liczbę obrazów, a StateImageIndex właściwość może być ustawiona na dowolną wartość równą lub niższą niż 14, tylko obrazy na pozycjach indeksu 0 i 1 są wyświetlane jako obrazy stanu.

Zobacz też

• StateImageList