ButtonBase.ImageList Свойство

Определение

Получает или задает свойство ImageList, содержащее изображение Image, отображенное в кнопке.

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; }
public System.Windows.Forms.ImageList? ImageList { get; set; }
member this.ImageList : System.Windows.Forms.ImageList with get, set
Public Property ImageList As ImageList

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

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

Примеры

В следующем примере кода используется производный класс 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

Комментарии

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

Примечание

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

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

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