ColumnHeader.ImageIndex Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ColumnHeader.cs

Získá nebo nastaví index obrázku zobrazeného v objektu 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

Hodnota vlastnosti

Int32

Index obrázku zobrazeného v souboru ColumnHeader.

Atributy

TypeConverterAttribute

Výjimky

ArgumentOutOfRangeException

value je menší než -1.

Poznámky

Vlastnost ImageIndex odkazuje na index obrázku určeného SmallImageListListView vlastností, která obsahuje ColumnHeader. Vlastnost ImageIndex vrátí -1 pokud není SmallImageList nastavena na obsahující ListView. Obrázek zobrazený ve sloupci se obvykle používá k označení stavu položek ve sloupci.

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 ImageKey nastavíte, ImageIndex vlastnost se automaticky nastaví na -1. Pokud vlastnost nastavíte ImageIndexImageKey , nastaví se 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 je však zachována interně a používá se při přiřazení jiného ImageList objektu ImageList k vlastnosti. Pokud má nová ImageList přiřazená ImageList vlastnost hodnotu vlastnosti ImageList.ImageCollection.Count , která je menší nebo rovna hodnotě přiřazené k ImageIndex vlastnosti minus jedna (pro účet kolekce je index založený na nule), ImageIndex hodnota vlastnosti se upraví na jednu menší než Count hodnota vlastnosti. Představte si například ovládací prvek tlačítka, jehož ImageList má tři obrázky a jehož ImageIndex vlastnost je nastavena 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.