ColumnHeader.ImageIndex Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ColumnHeader.cs

içinde ColumnHeadergö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.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

Özellik Değeri

Int32

içinde ColumnHeadergörüntülenen görüntünün dizini.

Öznitelikler

TypeConverterAttribute

Özel durumlar

ArgumentOutOfRangeException

value -1'den küçüktür.

Açıklamalar

özelliği, ImageIndex öğesini içeren özelliği ListView tarafından SmallImageList belirtilen bir görüntünün dizinine ColumnHeaderbaşvurur. özelliği, ImageIndex içeren ListViewüzerinde ayar yoksa SmallImageList -1 döndürür. Bir sütunda görüntülenen görüntü genellikle sütundaki öğelerin durumunu belirtmek için kullanılır.

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 , ImageIndex özelliği 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 nullImageIndex değiştirilirse, ö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ğine atanan ImageIndex değerden 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 bir küçük değere ayarlanır. Örneğin, üç görüntüsü olan ImageList ve ImageIndex özelliği 2 olarak ayarlanmış bir düğme denetimi düşünün. Düğmeye yalnızca iki resim içeren bir yeni ImageList atanırsa, ImageIndex değer 1 olarak değişir.