ButtonBase.ImageList Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.