Export (0) Print
Expand All

ToolStripItem.ImageIndex Property

Gets or sets the index value of the image that is displayed on the item.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[BrowsableAttribute(false)]
[RelatedImageListAttribute("Owner.ImageList")]
public int ImageIndex { get; set; }

Property Value

Type: System.Int32
The zero-based index of the image in the ImageList that is displayed for the item. The default is -1, signifying that the image list is empty.

ExceptionCondition
ArgumentException

The value specified is less than -1.

The ImageIndex property specifies the position of the image in the image list. The ImageKey property specifies the image itself.

The Image, ImageAlign, ImageIndex, ImageKey, and ImageScaling properties pertain to various aspects of image handling. Use images in ToolStrip controls by setting these properties directly or by setting the run-time–only ImageList property.

Image scaling is determined by the interaction of properties in both ToolStrip and ToolStripItem, as follows:

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft