ToolStripItem.ImageIndex Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia wartość indeksu obrazu wyświetlanego na elemencie.

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

Wartość właściwości

Int32

Indeks oparty na zerach obrazu w ImageList wyświetlonym elemencie. Wartość domyślna to -1, co oznacza, że lista obrazów jest pusta.

Atrybuty

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Wyjątki

ArgumentOutOfRangeException

value wartość jest mniejsza niż -1.

Uwagi

ImageKey i ImageIndex wzajemnie wykluczają się, co oznacza, że jeśli jest ustawiona, druga jest ustawiona na nieprawidłową wartość i ignorowana. Jeśli właściwość zostanie ustawiona ImageKey , ImageIndex właściwość zostanie automatycznie ustawiona na -1. Jeśli właściwość zostanie ustawiona ImageIndex , ImageKey właściwość zostanie automatycznie ustawiona na pusty ciąg ("").

Właściwości Image, ImageAlign, , ImageIndexi ImageKeyImageScaling odnoszą się do różnych aspektów obsługi obrazów. Użyj obrazów w ToolStrip kontrolkach, ustawiając te właściwości bezpośrednio lub ustawiając właściwość tylko ImageList w czasie wykonywania.

Skalowanie obrazów jest określane przez interakcję właściwości w systemach ToolStrip i ToolStripItem, w następujący sposób:

• ImageScalingSize to skala obrazu końcowego określona przez kombinację ustawienia obrazu ImageScaling i ustawienia kontenera AutoSize .

  • Jeśli AutoSize wartość to true (wartość domyślna) i ToolStripItemImageScaling to SizeToFit, nie występuje skalowanie obrazu, a ToolStrip rozmiar to największy element lub zalecany minimalny rozmiar.

  • Jeśli AutoSize jest i ToolStripItemImageScaling jest Nonefalse , ani obraz, ani ToolStrip skalowanie nie występuje.

ImageList Jeśli wartość właściwości zostanie zmieniona na null, ImageIndex właściwość zwróci jego wartość domyślną, -1. Jednak przypisana ImageIndex wartość jest zachowywana wewnętrznie i używana, gdy inny ImageList obiekt jest przypisany do ImageList właściwości. Jeśli nowa ImageList przypisana do ImageList właściwości ma ImageList.ImageCollection.Count wartość właściwości, która jest mniejsza lub równa wartości przypisanej ImageIndex do właściwości minus jeden (aby uwzględnić kolekcję będącą indeksem zerowym), ImageIndex wartość właściwości jest dostosowywana do wartości mniejszej niż Count wartość właściwości. Rozważmy na przykład kontrolkę przycisku z ImageList trzema obrazami i właściwością ImageIndex ustawioną na 2. Jeśli nowy ImageList , który ma tylko dwa obrazy, zostanie przypisany do przycisku, ImageIndex wartość zmieni się na 1.