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.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

Значение свойства

Int32

Возвращает или задает начинающийся с нуля индекс изображения в объекте ImageList, отображаемого для данного элемента.

Атрибуты

TypeConverterAttribute RelatedImageListAttribute

Исключения

ArgumentOutOfRangeException

Заданное для этого свойства значение меньше -1.

-или-

Заданное для этого свойства значение больше 14.

Комментарии

Это свойство позволяет указать индекс в назначенное ImageList свойству StateImageList связанного ListView элемента управления, где хранятся изображения состояния, отображаемые слева от элемента. Как правило, изображение состояния — это выбранный или снятый флажок или изображение, которое предназначено для представления выбранных или снятных состояний элемента. Если для StateImageList свойства не указано значение, ListView элемент управления отображает флажок CheckBoxes по умолчанию, если для свойства элемента управления задано значение true.

Примечание

Хотя указанное ImageList в свойстве StateImageList может содержать любое количество изображений, а StateImageIndex свойство может иметь любое значение, равное или меньше 14, только изображения с индексами 0 и 1 отображаются как изображения состояния.

См. также раздел

• StateImageList