ColumnHeader.ImageIndex Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает индекс изображения, отображаемого в ColumnHeader.

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.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

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

Int32

Индекс изображения, отображаемого в ColumnHeader.

Атрибуты

TypeConverterAttribute

Исключения

ArgumentOutOfRangeException

Значение value меньше -1.

Комментарии

Свойство ImageIndex ссылается на индекс изображения, заданного свойством SmallImageListListView объекта , который содержит ColumnHeader. Свойство ImageIndex возвращает значение -1, если в содержающем ListViewобъекте не SmallImageList задано значение . Изображение, отображаемое в столбце, обычно используется для указания состояния элементов в столбце.

ImageKey и ImageIndex являются взаимоисключающими, т. е. если задано одно значение, то для другого задано недопустимое значение и игнорируется. Если задано ImageKey свойство , ImageIndex для свойства автоматически устанавливается значение -1. Кроме того, если задать ImageIndex свойство , ImageKey автоматически устанавливается пустая строка ("").

ImageList Если значение свойства изменяется на null, ImageIndex свойство возвращает значение по умолчанию – -1. Однако назначенное ImageIndex значение сохраняется внутри и используется, когда свойству ImageList назначается другой ImageList объект. Если новый ImageList объект, назначенный ImageList.ImageCollection.Count свойствуImageList, имеет значение свойства, которое меньше или равно значению, назначенному свойствуImageIndex, за вычетом единицы (учитывая, что коллекция является отсчитываемой от нуля индексом), ImageIndex значение свойства корректируется на единицу меньше Count значения свойства. Например, рассмотрим элемент управления "Кнопка", который ImageList содержит три изображения и свойство которого ImageIndex имеет значение 2. Если кнопке назначен новый ImageList объект с двумя изображениями, ImageIndex значение изменится на 1.