Gewusst wie: Hinzufügen oder Entfernen von Bildern mit der ImageList-Komponente in Windows Forms

Artikel
09/02/2008

Aktualisiert: November 2007

Die ImageList-Komponente in Windows Forms wird normalerweise mit Bildern gefüllt, bevor sie einem Steuerelement zugeordnet wird. Bilder können jedoch hinzugefügt oder entfernt werden, nachdem die Bildliste einem Steuerelement zugeordnet wurde.

Hinweis:
Achten Sie beim Entfernen von Bildern darauf, dass die ImageIndex-Eigenschaft aller verknüpften Steuerelemente weiterhin gültig ist.

So fügen Sie Bilder programmgesteuert hinzu

Verwenden Sie die Add-Methode der Images-Eigenschaft der Bildliste.

Im folgenden Codebeispiel wurde als Speicherort für das Bild der Ordner Eigene Dateien festgelegt. Dieser Speicherort wird verwendet, weil vorausgesetzt werden kann, dass die meisten Computer mit dem Windows-Betriebssystem über einen Ordner mit dieser Bezeichnung verfügen. Dieser Speicherort ermöglicht es auch Benutzern mit minimalen Systemzugriffsberechtigungen, die Anwendung sicherer auszuführen. Im folgenden Codebeispiel wird vorausgesetzt, dass Sie über ein Formular verfügen, dem das ImageList-Steuerelement bereits hinzugefügt wurde.

Public Sub LoadImage()
   Dim myImage As System.Drawing.Image = _
     Image.FromFile _
   (System.Environment.GetFolderPath _
   (System.Environment.SpecialFolder.Personal) _
   & "\Image.gif")
   ImageList1.Images.Add(myImage)
End Sub

public void addImage()
{
// Be sure that you use an appropriate escape sequence (such as the 
// @) when specifying the location of the file.
   System.Drawing.Image myImage = 
     Image.FromFile
   (System.Environment.GetFolderPath
   (System.Environment.SpecialFolder.Personal)
   + @"\Image.gif");
   imageList1.Images.Add(myImage);
}

public:
   void addImage()
   {
   // Replace the bold image in the following sample 
   // with your own icon.
   // Be sure that you use an appropriate escape sequence (such as 
   // \\) when specifying the location of the file.
      System::Drawing::Image ^ myImage = 
         Image::FromFile(String::Concat(
         System::Environment::GetFolderPath(
         System::Environment::SpecialFolder::Personal),
         "\\Image.gif"));
      imageList1->Images->Add(myImage);
   }

So fügen Sie Bilder mit einem Schlüsselwert hinzu

Verwenden Sie eine der Add-Methoden der Images-Eigenschaft der Bildliste, die einen Schlüsselwert verwendet.

Im folgenden Codebeispiel wurde als Speicherort für das Bild der Ordner Eigene Dateien festgelegt. Dieser Speicherort wird verwendet, weil vorausgesetzt werden kann, dass die meisten Computer mit dem Windows-Betriebssystem über einen Ordner mit dieser Bezeichnung verfügen. Dieser Speicherort ermöglicht es auch Benutzern mit minimalen Systemzugriffsberechtigungen, die Anwendung sicherer auszuführen. Im folgenden Codebeispiel wird vorausgesetzt, dass Sie über ein Formular verfügen, dem das ImageList-Steuerelement bereits hinzugefügt wurde.
```
Public Sub LoadImage()
   Dim myImage As System.Drawing.Image = _
     Image.FromFile _
   (System.Environment.GetFolderPath _
   (System.Environment.SpecialFolder.Personal) _
   & "\Image.gif")
   ImageList1.Images.Add("myPhoto", myImage)
End Sub
```

So entfernen Sie alle Bilder programmgesteuert

Verwenden Sie die Remove-Methode, um ein einzelnes Bild zu entfernen.

– oder –

Verwenden Sie die Clear-Methode, um alle Bilder in der Bildliste zu löschen.
```
' Removes the first image in the image list
ImageList1.Images.Remove(myImage)
' Clears all images in the image list
ImageList1.Images.Clear()
```

So entfernen Sie Bilder anhand des Schlüsselwerts

Verwenden Sie die RemoveByKey-Methode, um ein einzelnes Bild anhand seines Schlüsselwerts zu entfernen.
```
' Removes the image named "myPhoto" from the list.
ImageList1.Images.RemoveByKey("myPhoto")
```

Siehe auch

Referenz

Übersicht über die ImageList-Komponente (Windows Forms)

Weitere Ressourcen

ImageList-Komponente (Windows Forms)

Bilder, Bitmaps und Metadateien

Freigeben über