ToolStripItem.ImageIndex Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Öğenin üzerinde görüntülenen görüntünün dizin değerini alır veya ayarlar.

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

Özellik Değeri

Int32

Öğesi için görüntülenen içindeki ImageList görüntünün sıfır tabanlı dizini. Görüntü listesinin boş olduğunu belirten varsayılan değer -1'dir.

Öznitelikler

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Özel durumlar

ArgumentOutOfRangeException

value -1'den küçük.

Açıklamalar

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 dize ("") olarak ayarlanır.

Image, ImageAlign, , ImageIndex, ImageKeyve ImageScaling özellikleri, görüntü işlemenin çeşitli yönleriyle ilgili. Bu özellikleri doğrudan ayarlayarak veya yalnızca ImageList çalışma zamanı özelliğini ayarlayarak denetimlerdeki ToolStrip görüntüleri kullanın.

Görüntü ölçeklendirme, hem hem ToolStripItemde ToolStrip içindeki özelliklerin etkileşimi tarafından aşağıdaki gibi belirlenir:

• ImageScalingSize , görüntünün ayarının ve kapsayıcı ayarının birleşimi tarafından belirlenen son görüntünün ImageScaling ölçeğidir AutoSize .

  • ise AutoSize true (varsayılan) ve ToolStripItemImageScaling ise SizeToFit, görüntü ölçeklendirmesi gerçekleşmez ve ToolStrip boyut en büyük öğenin veya belirlenen en düşük boyutun boyutudur.

  • ve AutoSize ToolStripItemImageScaling ise false None, görüntü veya ToolStrip ölçeklendirme gerçekleşmez.

ImageList Özellik değeri olarak değiştirilirsenullImageIndex, ö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, özellik değerine 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 olmasını hesaba katmak için), ImageIndex özellik değeri özellik değerinden Count bir küçüke ayarlanır. Örneğin, üç görüntüsü olan ImageList ve ImageIndex özelliği 2 olarak ayarlanmış bir düğme denetimini düşünün. Düğmeye yalnızca iki resim içeren bir yeni ImageList atanırsa, ImageIndex değer 1 olarak değişir.