ListViewItem.ImageIndex Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia indeks obrazu wyświetlanego dla elementu.
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 IntegerWartość właściwości
Indeks oparty na zerach obrazu w ImageList wyświetlonym elemencie. Wartość domyślna to -1.
- Atrybuty
Wyjątki
value wartość jest mniejsza niż -1.
Uwagi
Wartość tej właściwości zależy od wartości ImageList właściwości. W zależności od bieżącej wartości View właściwości ListView kontrolki skojarzonej z elementem, ImageList używany przez element może być określony we LargeImageList właściwości lub SmallImageList właściwości kontrolki ListView . View Jeśli właściwość jest ustawiona na LargeIcon, ImageList jest używana określona we LargeImageList właściwości . W przeciwnym razie jest używana określona SmallImageListImageList we właściwości. Obrazy zdefiniowane w określonej właściwości ImageListSmallImageList powinny mieć takie same pozycje indeksu, jak obrazy określone we ImageListLargeImageList właściwości. Jeśli pozycje indeksu są takie same dla obu ImageList kontrolek, można ustawić pojedynczą wartość indeksu dla ImageIndex właściwości, a odpowiedni obraz będzie wyświetlany niezależnie od wartości View właściwości kontrolki ListView .
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.
