ToolStripItem.ImageIndex Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Ausnahmen

ArgumentOutOfRangeException

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:

• ImageScalingSize ist die Skalierung des endgültigen Bilds, wie durch die Kombination der Einstellung des Bilds ImageScaling und der Einstellung des Containers AutoSize bestimmt.

  • true Wenn AutoSize (standard) und ist SizeToFit, tritt keine Bildskalierung auf, und ToolStripItemImageScaling die ToolStrip Größe ist das der größten Elemente oder eine vorgeschriebene Mindestgröße.

  • false Wenn AutoSize es sich ToolStripItemImageScaling Noneum ein Bild oder ToolStrip eine Skalierung handelt, tritt keine Skalierung auf.

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.