ColumnHeader.ImageIndex Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia indeks obrazu wyświetlanego w obiekcie 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

Wartość właściwości

Int32

Indeks obrazu wyświetlanego w obiekcie ColumnHeader.

Atrybuty

TypeConverterAttribute

Wyjątki

ArgumentOutOfRangeException

value wartość jest mniejsza niż -1.

Uwagi

Właściwość ImageIndex odwołuje się do indeksu obrazu określonego ListView przez SmallImageList właściwość , która zawiera ColumnHeaderelement . Właściwość ImageIndex zwraca wartość -1, jeśli nie ma SmallImageList ustawionego elementu zawierającego ListViewwartość . Obraz wyświetlany w kolumnie jest zwykle używany do wskazywania stanu elementów w kolumnie.

ImageKey i ImageIndex wzajemnie wykluczają się, co oznacza, że jeśli jest ustawiona, druga jest ustawiona na nieprawidłową wartość i ignorowana. Jeśli właściwość zostanie ustawiona ImageKey , ImageIndex właściwość zostanie automatycznie ustawiona na -1. Jeśli właściwość zostanie ustawiona ImageIndex , ImageKey właściwość zostanie automatycznie ustawiona na pusty ciąg ("").

ImageList Jeśli wartość właściwości zostanie zmieniona na null, ImageIndex właściwość zwróci jego wartość domyślną, -1. Jednak przypisana ImageIndex wartość jest zachowywana wewnętrznie i używana, gdy inny ImageList obiekt jest przypisany do ImageList właściwości. Jeśli nowa ImageList przypisana do ImageList właściwości ma ImageList.ImageCollection.Count wartość właściwości, która jest mniejsza lub równa wartości przypisanej ImageIndex do właściwości minus jeden (aby uwzględnić kolekcję będącą indeksem zerowym), ImageIndex wartość właściwości jest dostosowywana do wartości mniejszej niż Count wartość właściwości. Rozważmy na przykład kontrolkę przycisku z ImageList trzema obrazami i właściwością ImageIndex ustawioną na 2. Jeśli nowy ImageList , który ma tylko dwa obrazy, zostanie przypisany do przycisku, ImageIndex wartość zmieni się na 1.