ToolStripItem.ImageIndex Egenskap

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

Egenskapsvärde

Det nollbaserade indexet för bilden i ImageList som visas för objektet. Standardvärdet är -1, vilket betyder att bildlistan är tom.

Attribut

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Undantag

Kommentarer

ImageKey och ImageIndex är ömsesidigt uteslutande, vilket innebär att om det ena anges, anges det andra till ett ogiltigt värde och ignoreras. Om du anger egenskapen ImageKey anges egenskapen ImageIndex automatiskt till -1. Om du anger ImageIndex egenskapen ImageKey anges den också automatiskt till en tom sträng ("").

Egenskaperna Image, ImageAlign, ImageIndex, ImageKeyoch ImageScaling gäller olika aspekter av bildhantering. Använd avbildningar i ToolStrip kontroller genom att ange dessa egenskaper direkt eller genom att ange egenskapen körtid.ImageList

Bildskalning bestäms av interaktionen mellan egenskaper i både ToolStrip och ToolStripItemenligt följande:

• ImageScalingSize är skalan för den slutliga avbildningen enligt kombinationen av avbildningens ImageScaling inställning och containerns AutoSize inställning.

  • Om AutoSize är true (standard) och ToolStripItemImageScaling är SizeToFitsker ingen bildskalning och ToolStrip storlek är det största objektet eller en föreskriven minsta storlek.

  • Om AutoSize är false och ToolStripItemImageScaling är Nonesker varken avbildning eller ToolStrip skalning.

Om egenskapsvärdet ImageList ändras till nullImageIndex returnerar egenskapen standardvärdet -1. Det tilldelade ImageIndex värdet behålls dock internt och används när ett annat ImageList objekt tilldelas egenskapen ImageList . Om den nya ImageList tilldelade ImageList egenskapen har ett ImageList.ImageCollection.Count egenskapsvärde som är mindre än eller lika med det värde som tilldelats ImageIndex egenskapen minus ett (för att ta hänsyn till att samlingen är ett nollbaserat index) ImageIndex justeras egenskapsvärdet till ett mindre än egenskapsvärdet Count . Överväg till exempel en knappkontroll vars ImageList tre bilder och vars ImageIndex egenskap är inställd på 2. Om en ny ImageList som bara har två bilder tilldelas knappen ImageIndex ändras värdet till 1.