ButtonBase.ImageList Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die ImageList ab, die das auf einem Schaltflächen-Steuerelement angezeigte Image enthält, oder legt diese fest.

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

Eigenschaftswert

ImageList

ImageList. Der Standardwert ist null.

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet und Button die ImageList Eigenschaften und ImageIndex festgelegt. Dieser Code erfordert, dass ein ImageList erstellt wurde und ihm mindestens eine Image zugewiesen wurde. Dieser Code erfordert auch, dass Sie ein Bitmapbild mit dem Namen MyBitMap.bmp im C:\Graphics 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 oder ImageIndex festgelegt ist, wird die Image -Eigenschaft festgelegt null, was ihr Standardwert ist.

Hinweis

Wenn der ImageList Eigenschaftswert in nullgeändert wird, 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 der Eigenschaft zugewiesene ImageList neue ImageList Eigenschaft einen ImageList.ImageCollection.Count Eigenschaftswert aufweist, der kleiner als oder gleich dem der ImageIndex Eigenschaft minus 1 zugewiesenen Wert ist (da die Auflistung ein nullbasierter Index ist), wird der ImageIndex Eigenschaftswert auf eins kleiner als der Count Eigenschaftswert angepasst. Betrachten Sie beispielsweise ein Schaltflächensteuerelement, dessen ImageList Drei Bilder aufweist und dessen ImageIndex Eigenschaft auf 2 festgelegt ist. Wenn der Schaltfläche ein neues ImageList Bild mit nur zwei Bildern zugewiesen ist, ändert sich der ImageIndex Wert in 1.

Weitere Informationen

• Image
• ImageIndex