Freigeben über


ToolStripItem.ImageIndex Eigenschaft

Definition

Ruft den Indexwert des Bilds ab, das im Element angezeigt wird, oder legt diesen fest.

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

Eigenschaftswert

Int32

Der nullbasierte Index des Bilds in der ImageList, der für das Element angezeigt wird. Der Standardwert ist -1 und gibt an, dass die Bildliste leer ist.

Attribute

Ausnahmen

value ist kleiner als -1.

Hinweise

ImageKey und ImageIndex sind gegenseitig exklusiv, d. h. wenn eine festgelegt ist, wird der andere auf einen ungültigen Wert festgelegt und ignoriert. Wenn Sie die Eigenschaft festlegen, wird die ImageKey ImageIndex Eigenschaft automatisch auf -1 festgelegt. Wenn Sie die Eigenschaft festlegen, wird die ImageIndex ImageKey Eigenschaft automatisch auf eine leere Zeichenfolge ("") festgelegt.

Die ImageEigenschaften , ImageIndexImageAlignImageKeyund ImageScaling Eigenschaften beziehen sich auf verschiedene Aspekte der Bildbehandlung. Verwenden Sie Bilder in ToolStrip Steuerelementen, indem Sie diese Eigenschaften direkt festlegen oder die laufzeitgeschützte ImageList Eigenschaft festlegen.

Die Bildskalierung wird durch die Interaktion von Eigenschaften in beiden ToolStrip und ToolStripItemwie folgt bestimmt:

Wenn der Eigenschaftswert in nullgeändert wird, gibt die ImageList ImageIndex Eigenschaft ihren Standardwert zurück, -1. Der zugewiesene ImageIndex Wert wird jedoch intern aufbewahrt und verwendet, wenn einem anderen ImageList Objekt die ImageList Eigenschaft zugewiesen wird. Wenn der neue ImageList , ImageList dem Eigenschaft zugewiesene Eigenschaft einen Eigenschaftswert aufweist ImageList.ImageCollection.Count , der kleiner oder gleich dem Wert ImageIndex ist, der der Eigenschaft minus 1 zugewiesen ist (um die Auflistung als nullbasierten Index zu berücksichtigen), wird der ImageIndex Eigenschaftswert auf einen kleiner als den Count Eigenschaftswert angepasst. Betrachten Sie beispielsweise ein Schaltflächensteuerelement, dessen ImageList Eigenschaft auf 2 festgelegt ist.ImageIndex Wenn einer neuen ImageList , die nur zwei Bilder aufweist, der Schaltfläche zugewiesen wird, ändert sich der ImageIndex Wert auf 1.

Gilt für