ListViewItem.ImageIndex Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает индекс изображения, выводимого для данного элемента.
public:
property int ImageIndex { int get(); void set(int value); };[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
public int ImageIndex { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
member this.ImageIndex : int with get, setPublic Property ImageIndex As IntegerЗначение свойства
Возвращает или задает начинающийся с нуля индекс изображения в ImageList, отображаемого для данного элемента. Значение по умолчанию — -1.
- Атрибуты
Исключения
Значение value меньше -1.
Комментарии
Значение этого свойства зависит от значения ImageList свойства. В зависимости от текущего View значения свойства элемента управления, связанного ListView с элементом, используемый элементом может ImageList быть указан в LargeImageList свойстве или SmallImageList свойстве ListView элемента управления. View Если свойство имеет значение LargeIcon, используется указанный ImageList в свойстве; в LargeImageList противном случае используется указанный ImageList в свойствеSmallImageList. Изображения, ImageList определенные в указанном в свойстве SmallImageList , должны иметь те же позиции индекса, что и изображения, указанные ImageList в свойстве LargeImageList . Если позиции индекса одинаковы для обоих ImageList элементов управления, можно задать одно значение индекса для ImageIndex свойства, и соответствующее изображение будет отображаться независимо от значения View свойства ListView элемента управления.
ImageKey и ImageIndex являются взаимоисключающими, то есть если один задан, другой имеет недопустимое значение и игнорируется. Если задано ImageKey свойство, ImageIndex свойство автоматически устанавливается равным –1. Кроме того, если задать ImageIndex свойство, автоматически ImageKey устанавливается пустая строка ("").
ImageList Если значение свойства измененоnull, ImageIndex свойство возвращает значение по умолчанию –1. Однако назначенное ImageIndex значение сохраняется внутри системы и используется, когда другому ImageList объекту ImageList присваивается свойство. Если новое ImageList , назначенное свойству ImageList , имеет ImageList.ImageCollection.Count значение свойства, которое меньше или равно значению, назначенному ImageIndex свойству минус один (для учета коллекции, являющейся отсчитывающимся от нуля индексом), ImageIndex значение свойства корректируется на одно меньше, чем Count значение свойства.
Например, рассмотрим элемент управления "Кнопка", имеющий ImageList три изображения и свойство которого ImageIndex имеет значение 2. Если кнопке назначено новое изображение ImageList , которое содержит только два изображения, ImageIndex значение изменится на 1.