ButtonBase.ImageList Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

ButtonBase.cs

Возвращает или задает объект 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; }

member this.ImageList : System.Windows.Forms.ImageList with get, set

Public Property ImageList As ImageList

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

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 значение сохраняется внутри и используется при назначении другому ImageList свойству ImageList . Если новому ImageList свойству ImageList присвоено ImageList.ImageCollection.Count значение свойства, которое меньше или равно значению, назначенному ImageIndex свойству минус один (поскольку коллекция является отсчитываемой от нуля), ImageIndex значение свойства корректируется до одного меньше Count значения свойства. Например, рассмотрим элемент управления кнопкой с ImageList тремя изображениями и свойством которого ImageIndex задано значение 2. Если для кнопки назначено только ImageList два изображения, ImageIndex значение изменится на 1.

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

• Image
• ImageIndex