ColumnHeader.ImageIndex Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia indeks obrazu wyświetlanego w pliku 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 pliku 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 przez SmallImageList właściwość ListView , 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 jeden jest ustawiony, drugi jest ustawiony na nieprawidłową wartość i ignorowany. Jeśli ustawisz ImageKey właściwość , właściwość zostanie automatycznie ustawiona ImageIndex na -1. Alternatywnie, jeśli ustawisz ImageIndex właściwość , ImageKey właściwość zostanie automatycznie ustawiona na pusty ciąg ("").

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