ToolStripItem.ImageIndex Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property ImageIndex As IntegerEigenschaftswert
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:
ImageScalingSize ist die Skalierung des endgültigen Bilds, wie durch die Kombination der Einstellung des Bilds ImageScaling und der Einstellung des Containers AutoSize bestimmt.
trueWenn 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.falseWenn 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.