ToolStripItem.ImageIndex Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de indexwaarde op van de afbeelding die op het item wordt weergegeven of stelt u deze in.
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, setPublic Property ImageIndex As IntegerWaarde van eigenschap
De op nul gebaseerde index van de afbeelding in de ImageList afbeelding die voor het item wordt weergegeven. De standaardwaarde is -1, waarmee wordt aangegeven dat de lijst met afbeeldingen leeg is.
- Kenmerken
Uitzonderingen
value is kleiner dan -1.
Opmerkingen
ImageKey en ImageIndex wederzijds uitsluiten, wat betekent dat als de ene is ingesteld, de andere wordt ingesteld op een ongeldige waarde en genegeerd. Als u de ImageKey eigenschap instelt, wordt de ImageIndex eigenschap automatisch ingesteld op -1. Als u de eigenschap instelt, wordt de ImageIndexImageKey eigenschap ook automatisch ingesteld op een lege tekenreeks ("").
De eigenschappen Image, ImageAlign, ImageIndex, ImageKeyen ImageScaling hebben betrekking op verschillende aspecten van de verwerking van afbeeldingen. Gebruik afbeeldingen in ToolStrip besturingselementen door deze eigenschappen rechtstreeks in te stellen of door de eigenschap alleen-runtime ImageList in te stellen.
Het schalen van afbeeldingen wordt als volgt bepaald door de interactie van eigenschappen in zowel ToolStrip als ToolStripItem:
ImageScalingSize is de schaal van de uiteindelijke afbeelding, zoals bepaald door de combinatie van de ImageScaling-instelling van de afbeelding en de AutoSize-instelling van de container.
Als AutoSize is
true(de standaardinstelling) en ToolStripItemImageScaling is SizeToFit, treedt er geen schaalaanpassing van afbeeldingen op en is de ToolStrip grootte dat van het grootste item of een voorgeschreven minimale grootte.Als AutoSize
falseis en ToolStripItemImageScalingNoneis, vinden noch afbeelding noch ToolStrip schalen plaats.
Als de ImageList eigenschapswaarde wordt gewijzigd nullin , retourneert de eigenschap de ImageIndex standaardwaarde -1. De toegewezen ImageIndex waarde wordt echter intern bewaard en gebruikt wanneer een ander ImageList object aan de ImageList eigenschap wordt toegewezen. Als de nieuwe ImageList die aan de ImageList eigenschap is toegewezen een ImageList.ImageCollection.Count eigenschapswaarde heeft die kleiner is dan of gelijk is aan de waarde die is toegewezen aan de ImageIndex eigenschap min één (om rekening te houden met de verzameling als een op nul gebaseerde index), wordt de ImageIndex eigenschapswaarde aangepast aan een waarde die kleiner is dan de Count eigenschapswaarde.
Denk bijvoorbeeld aan een knopbesturingselement met ImageList drie afbeeldingen en waarvan de ImageIndex eigenschap is ingesteld op 2. Als er ImageList slechts twee afbeeldingen aan de knop zijn toegewezen, wordt de ImageIndex waarde gewijzigd in 1.