ListViewItem.ImageIndex Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá nebo nastaví index obrázku, který se zobrazí pro položku.

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, set
Public Property ImageIndex As Integer

Hodnota vlastnosti

Int32

Index na základě nuly obrázku, ImageList který se zobrazí pro položku. Výchozí hodnota je -1.

Atributy
TypeConverterAttribute

Výjimky

ArgumentOutOfRangeException

value je menší než -1.

Poznámky

Hodnota této vlastnosti závisí na hodnotě ImageList vlastnosti. V závislosti na aktuální hodnotě View vlastnosti ListView ovládacího prvku přidruženého k položce může ImageList být použitá položka jedna zadaná ve LargeImageList vlastnosti nebo SmallImageList vlastnost ListView ovládacího prvku. View Pokud je vlastnost nastavena na LargeIcon, ImageList zadaný v LargeImageList vlastnosti se použije; jinak ImageList se použije zadaný v SmallImageList vlastnosti. Obrázky definované v ImageList zadané vlastnosti SmallImageList by měly mít stejné pozice indexu jako obrázky v ImageList zadané vlastnosti LargeImageList . Pokud jsou pozice indexu pro oba ImageList ovládací prvky stejné, můžete nastavit jednu indexovou hodnotu vlastnosti ImageIndex a příslušný obrázek se zobrazí bez ohledu na hodnotu View vlastnosti ListView ovládacího prvku.

ImageKey a ImageIndex vzájemně se vylučují, což znamená, že pokud je nastavena jedna, druhá je nastavena na neplatnou hodnotu a ignorována. Pokud vlastnost nastavíte ImageKey , ImageIndex vlastnost se automaticky nastaví na -1. Případně pokud vlastnost nastavíte ImageIndex , nastaví se ImageKey automaticky na prázdný řetězec ("").

ImageList Pokud se hodnota vlastnosti změní na null, ImageIndex vrátí vlastnost výchozí hodnotu -1. Přiřazená ImageIndex hodnota se ale uchovává interně a používá se při přiřazení jiného ImageList objektu k ImageList vlastnosti. Pokud má nová přiřazená ImageList vlastnost ImageList.ImageCollection.Count hodnotu vlastnosti, která je menší nebo rovna hodnotě přiřazené k ImageIndex vlastnosti minus jedna (pro účet kolekce je nulový index), ImageIndex hodnota vlastnosti se upraví na jednu menší než Count hodnota ImageList vlastnosti. Představte si například ovládací prvek tlačítka, jehož ImageList má tři obrázky a jehož ImageIndex vlastnost je nastavená na hodnotu 2. Pokud je tlačítku přiřazena nová ImageList , která má pouze dva obrázky, změní se ImageIndex hodnota na 1.

Platí pro

Viz také