Freigeben über


ButtonBase.ImageList Eigenschaft

Definition

Dient zum Abrufen oder Festlegen der Eigenschaft, die ImageList das Image auf einem Schaltflächensteuerelement angezeigte Enthält.

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

Eigenschaftswert

Ein ImageList-Element. Der Standardwert ist null.

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet und Button die und ImageIndex die ImageList Eigenschaften festgelegt. Dieser Code erfordert, dass eine ImageList erstellt wurde und ihm mindestens eins Image zugewiesen wurde. Dieser Code erfordert außerdem, dass Sie ein Bitmapbild mit dem C:\Graphics Namen MyBitMap.bmp "Im Verzeichnis" gespeichert haben.

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

Hinweise

Wenn die ImageList Eigenschaft ImageIndex festgelegt wird, wird die Image Eigenschaft festgelegt null, was der Standardwert ist.

Hinweis

Wenn der ImageList Eigenschaftswert geändert nullwird, gibt die ImageIndex Eigenschaft den Standardwert -1 zurück. Der zugewiesene ImageIndex Wert wird jedoch intern beibehalten und verwendet, wenn der ImageList Eigenschaft ein anderer ImageList zugewiesen wird. Wenn die neue ImageList , der ImageList Eigenschaft zugewiesene Eigenschaft einen ImageList.ImageCollection.Count Eigenschaftswert aufweist, der kleiner oder gleich dem Wert ist, der ImageIndex der Eigenschaft minus 1 zugewiesen ist (da die Auflistung ein nullbasierter Index ist), wird der ImageIndex Eigenschaftswert auf einen Wert angepasst, der kleiner als der Count Eigenschaftswert ist. Betrachten Sie z. B. ein Schaltflächensteuerelement, dessen ImageList Eigenschaft drei Bilder aufweist und deren ImageIndex Eigenschaft auf 2 festgelegt ist. Wenn der Schaltfläche nur zwei ImageList Bilder zugewiesen sind, ändert sich der ImageIndex Wert in 1.

Gilt für:

Weitere Informationen