ButtonBase.ImageIndex Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

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