ButtonBase.ImageList Свойство

Определение

Получает или задает свойство ImageList, содержащее изображение Image, отображенное в кнопке.Gets or sets the ImageList that contains the Image displayed on a button control.

public:
 property System::Windows::Forms::ImageList ^ ImageList { System::Windows::Forms::ImageList ^ get(); void set(System::Windows::Forms::ImageList ^ value); };
public System.Windows.Forms.ImageList ImageList { get; set; }
member this.ImageList : System.Windows.Forms.ImageList with get, set
Public Property ImageList As ImageList

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

Объект ImageList.An ImageList. Значение по умолчанию — null.The default value is null.

Примеры

В следующем примере кода используется производный класс, 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 nullсвойство или, устанавливается свойство,котороеявляетсязначениемпоумолчанию.Image ImageListWhen the ImageList or ImageIndex property is set, the Image property is set null, which is its default value.

Примечание

Если значение nullсвойства изменяется на, ImageIndex свойство возвращает значение по умолчанию-1. ImageListIf 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 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 (because the collection is a zero-based index), the ImageIndex property value is adjusted to one less than the Count property value. Например, рассмотрим элемент управления ImageList Button с тремя изображениями, свойству которых ImageIndex присвоено значение 2.For example, consider a button control whose ImageList has three images and whose ImageIndex property is set to 2. Если кнопке назначено только два изображения ImageIndex , значение изменится на 1. ImageListIf a new ImageList that has only two images is assigned to the button, the ImageIndex value changes to 1.

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

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