ToolStripItem.ImageIndex Свойство

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Возвращает или задает значение индекса изображения, отображаемого на данном элементе.

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

Значение свойства

Int32

Возвращает или задает начинающийся с нуля индекс изображения в ImageList, отображаемого для данного элемента. По умолчанию используется значение -1, которое означает, что список изображений пуст.

Атрибуты
BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

Исключения

ArgumentOutOfRangeException

Значение value меньше -1.

Комментарии

ImageKey и ImageIndex являются взаимоисключающими, т. е. если задано одно из них, другой имеет недопустимое значение и игнорируется. Если задано ImageKey свойство, ImageIndex то для свойства автоматически задается значение -1. Кроме того, при установке ImageIndex свойства ImageKey автоматически устанавливается пустая строка ("").

Свойства Image, и ImageIndexImageAlignImageKeyImageScaling свойства относятся к различным аспектам обработки изображений. Используйте изображения в ToolStrip элементах управления, задав эти свойства напрямую или задав свойство только ImageList во время выполнения.

Масштабирование изображений определяется взаимодействием свойств в обоих ToolStrip и ToolStripItemследующим образом:

  • ImageScalingSize — это масштаб окончательного образа, определяемого сочетанием параметра образа ImageScaling и параметра контейнера AutoSize .

    • Если AutoSize значение равно true (по умолчанию) и ToolStripItemImageScaling не выполняется SizeToFitмасштабирование изображений, а ToolStrip размер — самый большой элемент или предписанный минимальный размер.

    • Если AutoSize это и ToolStripItemImageScaling естьNonefalse, ни изображение, ToolStrip ни масштабирование не происходит.

ImageList Если значение свойства измененоnull, ImageIndex свойство возвращает значение по умолчанию -1. Однако назначенное ImageIndex значение сохраняется внутри и используется, когда другому ImageList объекту ImageList присваивается свойство. Если новое ImageList , назначенное ImageList свойству, имеет ImageList.ImageCollection.Count значение свойства, которое меньше или равно значению, назначенному ImageIndex свойству минус один (для учета коллекции, являющейся отсчитывающимся от нуля индекса), ImageIndex значение свойства корректируется на одно значение меньше, чем Count значение свойства. Например, рассмотрим элемент управления "Кнопка", имеющий ImageList три изображения и свойство которого ImageIndex имеет значение 2. Если для кнопки назначено новое изображение ImageList с двумя изображениями, ImageIndex значение изменится на 1.

Применяется к