Udostępnij za pośrednictwem


ToolStripItem.ImageIndex Właściwość

Definicja

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

Wyjątki

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:

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.

Dotyczy