Share via


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

Die ImageList-Komponente in Windows Forms wird in der Regel mit Bildern gefüllt, bevor sie einem Steuerelement zugeordnet wird. Sie können jedoch auch noch Bilder hinzufügen und entfernen, nachdem Sie die Bildliste einem Steuerelement zugeordnet haben.

Hinweis

Wenn Sie Bilder entfernen, überprüfen Sie, ob die ImageIndex-Eigenschaft aller zugeordneten 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 ist der Pfad, der für den Speicherort des Bilds festgelegt ist, der Ordner Eigene Dokumente. Dieser Speicherort wird verwendet, da Sie davon ausgehen können, dass die meisten Computer, auf denen das Betriebssystem Windows ausgeführt wird, über diesen Ordner verfügen. Durch die Auswahl dieses Speicherorts können Benutzer*innen, die nur über minimale Zugriffsebenen für das System verfügen, die Anwendung sicherer ausführen. Das folgende Codebeispiel setzt voraus, dass Sie über ein Formular mit einem bereits hinzugefügten ImageList-Steuerelement verfügen.

    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 akzeptiert.

    Im folgenden Codebeispiel ist der Pfad, der für den Speicherort des Bilds festgelegt ist, der Ordner Eigene Dokumente. Dieser Speicherort wird verwendet, da Sie davon ausgehen können, dass die meisten Computer, auf denen das Betriebssystem Windows ausgeführt wird, über diesen Ordner verfügen. Durch die Auswahl dieses Speicherorts können Benutzer*innen, die nur über minimale Zugriffsebenen für das System verfügen, die Anwendung sicherer ausführen. Das folgende Codebeispiel setzt voraus, dass Sie über ein Formular mit einem bereits hinzugefügten ImageList-Steuerelement verfügen.

    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  
    
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("myPhoto", myImage);  
}  

So entfernen Sie alle Bilder programmgesteuert

  • Verwenden Sie die Remove-Methode zum Entfernen eines einzelnen Bilds.

    – oder –

    Verwenden Sie die Clear-Methode, um alle Bilder aus der Bildliste zu entfernen.

    ' Removes the first image in the image list  
    ImageList1.Images.Remove(myImage)  
    ' Clears all images in the image list  
    ImageList1.Images.Clear()  
    
// 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 nach Schlüssel

  • Verwenden Sie die RemoveByKey-Methode zum Entfernen eines einzelnen Bilds anhand seines Schlüssels.

    ' Removes the image named "myPhoto" from the list.  
    ImageList1.Images.RemoveByKey("myPhoto")  
    
// Removes the image named "myPhoto" from the list.  
imageList1.Images.RemoveByKey("myPhoto");  

Weitere Informationen