Freigeben über


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

Die Windows Forms-Komponente ImageList wird in der Regel mit Bildern aufgefüllt, bevor sie einem Steuerelement zugeordnet ist. Sie können jedoch 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 noch gültig ist.

So fügen Sie Bilder programmgesteuert hinzu

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

    Im folgenden Codebeispiel ist der Pfad, der den Speicherort des Bilds festlegt, der Ordner "Eigene Dokumente". Dieser Speicherort wird verwendet, da Sie davon ausgehen können, dass die meisten Computer, auf denen das Windows-Betriebssystem ausgeführt wird, diesen Ordner enthalten. Wenn Sie diesen Speicherort auswählen, können Benutzer, die minimale Systemzugriffsebenen haben, die Anwendung sicherer ausführen. Im folgenden Codebeispiel müssen Sie über ein Formular verfügen, das bereits ein ImageList Steuerelement hinzugefügt hat.

    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 Eigenschaft der Bildliste Images , die einen Schlüsselwert verwendet.

    Im folgenden Codebeispiel ist der Pfad, der den Speicherort des Bilds festlegt, der Ordner "Eigene Dokumente". Dieser Speicherort wird verwendet, da Sie davon ausgehen können, dass die meisten Computer, auf denen das Windows-Betriebssystem ausgeführt wird, diesen Ordner enthalten. Wenn Sie diesen Speicherort auswählen, können Benutzer, die minimale Systemzugriffsebenen haben, die Anwendung sicherer ausführen. Im folgenden Codebeispiel müssen Sie über ein Formular verfügen, das bereits ein ImageList Steuerelement hinzugefügt hat.

    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 der Remove Methode zum Entfernen eines einzelnen Bilds

    -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()
    
// 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 eines Schlüssels

  • Verwenden Sie die RemoveByKey-Methode, um ein einzelnes Bild anhand seiner Kennung zu entfernen.

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

Siehe auch