ListViewItem.ImageIndex Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Öğe için görüntülenen görüntünün dizinini alır veya ayarlar.
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 IntegerÖzellik Değeri
Öğesi için görüntülenen içindeki ImageList görüntünün sıfır tabanlı dizini. Varsayılan değer -1'dir.
- Öznitelikler
Özel durumlar
value -1'den küçüktür.
Açıklamalar
Bu özelliğin değeri özelliğin ImageList değerine bağlıdır. Öğeyle ilişkili denetimin özelliğinin View ListView geçerli değerine bağlı olarak, ImageList öğe tarafından kullanılan, denetimin LargeImageList özelliğinde veya SmallImageList özelliğinde ListView belirtilen değer olabilir. View özelliği olarak ayarlanırsa ImageList LargeIcon, özelliğinde LargeImageList belirtilen kullanılır; aksi takdirde, ImageList özelliğinde SmallImageList belirtilen kullanılır. özelliğinde belirtilen içinde ImageList tanımlanan görüntülerin, özelliğinde SmallImageList belirtilen LargeImageList görüntülerle ImageList aynı dizin konumları olmalıdır. Dizin konumları her iki denetim için de ImageList aynıysa, özellik için ImageIndex tek bir dizin değeri ayarlayabilirsiniz ve denetimin özelliğinin ListView değerinden View bağımsız olarak uygun görüntü görüntülenir.
ImageKey ve ImageIndex birbirini dışlar, yani biri ayarlanırsa, diğeri geçersiz bir değere ayarlanır ve yoksayılır. Özelliğini ayarlarsanız ImageKey özelliği ImageIndex otomatik olarak -1 olarak ayarlanır. Alternatif olarak, özelliğini ayarlarsanız ImageIndex , ImageKey otomatik olarak boş bir dizeye ("") ayarlanır.
ImageList Özellik değeri olarak değiştirilirsenullImageIndex, özellik varsayılan değeri olan -1 değerini döndürür. Ancak, atanan ImageIndex değer dahili olarak tutulur ve özelliğe başka bir ImageList nesne atandığında ImageList kullanılır. Özelliğe atanan yeni ImageList özelliğinImageList, özelliğe atanan ImageIndex değerden bir eksi bir değerinden küçük veya buna eşit bir ImageList.ImageCollection.Count özellik değeri varsa (koleksiyonun sıfır tabanlı bir dizin olduğunu hesaba katmak için), ImageIndex özellik değeri özellik değerinden Count küçük bir değere ayarlanır.
Örneğin, üç görüntüsü olan ImageList ve ImageIndex özelliği 2 olarak ayarlanmış bir düğme denetimini düşünün. Düğmeye yalnızca iki resim içeren bir yeni ImageList atanırsa, ImageIndex değer 1 olarak değişir.