ButtonBase.ImageIndex Свойство

Определение

Возвращает или задает значение индекса списка изображений для изображения, отображаемого на кнопке.Gets or sets the image list index value of the image displayed on the button control.

public:
 property int ImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

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

Начинающийся с нуля индекс, представляющий положение изображения в свойстве ImageList.A zero-based index, which represents the image position in an ImageList. Значение по умолчанию — -1.The default is -1.

Атрибуты

Исключения

Присвоенное значение меньше нижних границ свойства ImageIndex.The assigned value is less than the lower bounds of the ImageIndex.

Примеры

В следующем примере кода используется производный класс Button и устанавливаются свойства ImageList и ImageIndex.The following code example uses the derived class, Button and sets the ImageList and ImageIndex properties. Для этого кода требуется, чтобы был создан ImageList и был назначен минимум один Image.This code requires that an ImageList has been created and a minimum of one Image has been assigned to it. Этот код также требует наличия растрового изображения с именем MyBitMap.bmp, хранящегося в C:\Graphicsном каталоге.This code also requires that you have a bitmap image named MyBitMap.bmp stored in the C:\Graphics directory.

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.When the ImageIndex or ImageList properties are set, the Image property is set to its default value, null.

Примечание

Если значение свойства ImageList изменяется на null, свойство ImageIndex возвращает значение по умолчанию-1.If the ImageList property value is changed to null, the ImageIndex property returns its default value, -1. Однако присвоенное значение ImageIndex сохраняется внутренне и используется, когда свойству ImageList присваивается другой объект ImageList.However, the assigned ImageIndex value is retained internally and used when another ImageList object is assigned to the ImageList property. Если новое ImageList, назначенное свойству ImageList, имеет значение свойства ImageList.ImageCollection.Count, которое меньше или равно значению, назначенному свойству ImageIndex минус единица (для учета коллекции с нулевым индексом), значение свойства ImageIndex корректируется на единицу меньше значения свойства Count.If the new ImageList assigned to the ImageList property has an ImageList.ImageCollection.Count property value that is less than or equal to the value assigned to the ImageIndex property minus one (to account for the collection being a zero-based index), the ImageIndex property value is adjusted to one less than the Count property value. Например, рассмотрим элемент управления Button, у которого ImageList есть три изображения, для свойства ImageIndex которых установлено значение 2.For example, consider a button control whose ImageList has three images and whose ImageIndex property is set to 2. Если кнопке присвоено новое ImageList, имеющее только два изображения, ImageIndex значение изменится на 1.If a new ImageList that has only two images is assigned to the button, the ImageIndex value changes to 1.

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

Дополнительно