ButtonBase.ImageIndex Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

ButtonBase.cs

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

public:
 property int ImageIndex { int get(); void set(int value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

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

Int32

Отсчитываемый от нуля индекс, представляющий позицию изображения в объекте ImageList. Значение по умолчанию — -1.

Атрибуты

TypeConverterAttribute

Исключения

ArgumentOutOfRangeException

value меньше -1.

Примеры

В следующем примере кода используется производный класс и Button задаются ImageList свойства.ImageIndex Этот код требует, чтобы ImageList он был создан, и для него была назначена как минимум одна Image . Этот код также требует наличия растрового изображения с именем MyBitMap.bmp , хранящимся в каталоге C:\Graphics .

private:
   void AddMyImage()
   {
      // Assign an image to the imageList.
      imageList1->Images->Add( Image::FromFile( "C:\\Graphics\\MyBitmap.bmp" ) );
      // Assign the imageList to the button control.
      button1->ImageList = imageList1;
      // Select the image from the ImageList (using the ImageIndex property).
      button1->ImageIndex = 0;
   }

private void AddMyImage()
 {
    // Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.ImageList = ImageList1;
    // Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0;
 }

Private Sub AddMyImage()
    ' Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\Graphics\MyBitmap.bmp"))
    ' Assign the ImageList to the button control.   
    button1.ImageList = ImageList1
    ' Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0
End Sub

Комментарии

ImageIndex ImageList Если заданы свойства, Image свойство имеет значение nullпо умолчанию.

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

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

См. также раздел

• ImageList