ToolStripItem.ImageIndex Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví index hodnotu obrázku, který je zobrazen na položce.

public:
 property int ImageIndex { int get(); void set(int value); };

[System.ComponentModel.Browsable(false)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("Owner.ImageList")]
public int ImageIndex { get; set; }

[<System.ComponentModel.Browsable(false)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("Owner.ImageList")>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

Hodnota vlastnosti

Int32

Index obrázku založený na nule, ImageList který se zobrazí pro položku. Výchozí hodnota je -1, což znamená, že seznam obrázků je prázdný.

Atributy

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Výjimky

ArgumentOutOfRangeException

value je menší než -1.

Poznámky

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. Pokud vlastnost ImageIndex nastavíte, ImageKey nastaví se automaticky na prázdný řetězec ("").

Vlastnosti Image, , ImageIndexImageAlignImageKeya ImageScaling vlastnosti se týkají různých aspektů zpracování obrázků. Obrázky můžete použít v ToolStrip ovládacích prvcích nastavením těchto vlastností přímo nebo nastavením vlastnosti pouze ImageList za běhu.

Škálování obrázku je určeno interakcí vlastností v obou ToolStrip a ToolStripItemnásledujícím způsobem:

• ImageScalingSize je měřítko konečné image určené kombinací nastavení image ImageScaling a nastavení kontejneru AutoSize .

  • Pokud AutoSize je ( true výchozí) a ToolStripItemImageScaling je SizeToFit, nedojde k žádnému škálování obrázku a ToolStrip velikost je největší položka nebo předepsané minimální velikosti.

  • Pokud AutoSize je a ToolStripItemImageScaling false jeNone, není k obrázku ani ToolStrip škálování dochází.

Pokud se ImageList hodnota vlastnosti změní na null, vrátí ImageIndex vlastnost výchozí hodnotu -1. Přiřazená ImageIndex hodnota se však uchovává interně a používá se při přiřazení jiného ImageList objektu ImageList k vlastnosti. Pokud má nová ImageList přiřazená vlastnost ImageList hodnotu vlastnosti ImageList.ImageCollection.Count , která je menší nebo rovna hodnotě přiřazené vlastnosti ImageIndex minus jedna (pro účet kolekce je index založený na nule), ImageIndex je hodnota vlastnosti upravena 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á obsahuje pouze dva obrázky, ImageIndex hodnota se změní na 1.