Поделиться через

ToolStripItem.ImageIndex Свойство

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll
Исходный код:
ToolStripItem.cs
Исходный код:
ToolStripItem.cs
Исходный код:
ToolStripItem.cs
Исходный код:
ToolStripItem.cs
Исходный код:
ToolStripItem.cs

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

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 (по умолчанию) и ToolStripItemImageScalingSizeToFitне выполняется масштабирование изображений, а ToolStrip размер является самым большим элементом или заданным минимальным размером.

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

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

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