ButtonBase.ImageList-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property ImageList As ImageList
'Usage
Dim instance As ButtonBase
Dim value As ImageList

value = instance.ImageList

instance.ImageList = value

public ImageList ImageList { get; set; }

public:
property ImageList^ ImageList {
    ImageList^ get ();
    void set (ImageList^ value);
}

/** @property */
public ImageList get_ImageList ()

/** @property */
public void set_ImageList (ImageList value)

public function get ImageList () : ImageList

public function set ImageList (value : ImageList)

Eigenschaftenwert

Eine ImageList. Der Standardwert ist NULL (Nothing in Visual Basic).

Hinweise

Wenn die ImageList-Eigenschaft oder die ImageIndex-Eigenschaft festgelegt ist, wird die Image-Eigenschaft auf den Standardwert NULL (Nothing in Visual Basic) festgelegt.

Hinweis

Wenn der Wert der ImageList-Eigenschaft in NULL (Nothing in Visual Basic) geändert wird, gibt die ImageIndex-Eigenschaft ihren Standardwert (-1) zurück. Der zugewiesene ImageIndex-Wert wird aber intern beibehalten und verwendet, sobald der ImageList-Eigenschaft eine andere ImageList zugewiesen wurde. Wenn das neue ImageList-Objekt, das der ImageList-Eigenschaft zugewiesen ist, für die ImageList.ImageCollection.Count-Eigenschaft einen Wert besitzt, der kleiner oder gleich dem Wert, den die ImageIndex-Eigenschaft hat, minus 1 ist (weil der Index der Auflistung bei 0 (null) beginnt), wird der Wert der ImageIndex-Eigenschaft so angepasst, dass er um 1 kleiner als der Wert der Count-Eigenschaft ist. Stellen Sie sich beispielsweise ein Schaltflächen-Steuerelement vor, dessen ImageList drei Bilder enthält und dessen ImageIndex-Eigenschaft auf 2 festgelegt ist. Wenn der Schaltfläche eine neue ImageList zugewiesen wird, die nur zwei Bilder enthält, ändert sich der ImageIndex-Wert in 1.

Beispiel

Im folgenden Codebeispiel wird die abgeleitete Klasse Button verwendet, und die ImageList-Eigenschaft und ImageIndex-Eigenschaft werden festgelegt. Für diesen Code ist es erforderlich, dass eine ImageList erstellt und dieser mindestens ein Image zugewiesen wurde. Für diesen Code ist es außerdem erforderlich, dass im Verzeichnis C:\Graphics eine Bitmap mit dem Namen MyBitMap.bmp vorhanden ist.

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 'AddMyImage

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 void AddMyImage()
{
    // Assign an image to the ImageList.
    imageList1.get_Images().Add(Image.FromFile(
        "C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.set_ImageList(imageList1);
    // Select the image from the ImageList (using the ImageIndex property).    
    button1.set_ImageIndex(0);
} //AddMyImage

private function AddMyImage()
 {
    // Assign an image to the ImageList.
    ImageList1 = new 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;
 }

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ButtonBase-Klasse
ButtonBase-Member
System.Windows.Forms-Namespace
Image
ButtonBase.ImageIndex-Eigenschaft

Freigeben über