ToolStripItem.ImageIndex-Eigenschaft
Aktualisiert: November 2007
Ruft den Indexwert des Bilds ab, das im Element angezeigt wird, oder legt diesen fest.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
[BrowsableAttribute(false)] [RelatedImageListAttribute("Owner.ImageList")] public int ImageIndex { get; set; }
/** @property */
/** @attribute BrowsableAttribute(false) */
/** @attribute RelatedImageListAttribute("Owner.ImageList") */
public int get_ImageIndex()
/** @property */
/** @attribute BrowsableAttribute(false) */
/** @attribute RelatedImageListAttribute("Owner.ImageList") */
public void set_ImageIndex(int value)
public function get ImageIndex () : int public function set ImageIndex (value : int)
Eigenschaftenwert
Typ: System.Int32Der 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.
| Ausnahme | Bedingung |
|---|---|
| ArgumentException | Der angegebene Wert ist kleiner als -1. |
Die ImageIndex-Eigenschaft gibt die Position des Bilds in der Bildliste an. Die ImageKey-Eigenschaft gibt das Bild an.
Die Eigenschaften Image, ImageAlign, ImageIndex, ImageKey und ImageScaling betreffen verschiedene Aspekte der Bildbehandlung. Verwenden Sie Bilder in ToolStrip-Steuerelementen durch direktes Festlegen dieser Eigenschaften oder durch Festlegen ImageList-Eigenschaft nur zur Laufzeit.
Die Bildskalierung wird durch die Interaktion der Eigenschaften in ToolStrip und ToolStripItem folgendermaßen bestimmt:
ImageScalingSize ist die Skalierung des endgültigen Bilds entsprechend der Kombination aus der ImageScaling-Einstellung des Bilds und der AutoSize-Einstellung des Containers.
Wenn AutoSize auf true (Standardeinstellung) und ToolStripItemImageScaling auf SizeToFit festgelegt ist, erfolgt keine Bildskalierung, und die ToolStrip-Größe ist die des größten Elements oder die vorgegebene Mindestgröße.
Wenn AutoSize auf false und ToolStripItemImageScaling auf None festgelegt ist, werden weder das Bild noch der ToolStrip skaliert.
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
