Comment : ajouter ou supprimer des images avec le composant ImageList Windows Forms

Le composant ImageList Windows Forms est habituellement rempli d'images avant d'être associé à un contrôle. Toutefois, vous pouvez ajouter ou supprimer des images après que la liste d'images a été associée à un contrôle.

Pour ajouter des images par programme

• Utilisez la méthode Add de la propriété Images de la liste d'images.

  Dans l'exemple de code suivant, le chemin d'accès défini pour l'emplacement de l'image est le dossier Mes documents. La plupart des ordinateurs exécutant le système d'exploitation Windows disposent, en effet, de ce dossier. Le choix de cet emplacement permet également aux utilisateurs disposant de niveaux d'accès minimaux au système d'exécuter l'application avec plus de sécurité. L'exemple de code suivant requiert un formulaire auquel un contrôle ImageList a été ajouté.

  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);
     }
  

Pour ajouter des images avec une valeur de clé.

• Utilisez une des méthodes Add de la propriété Images de la liste d'images qui utilise une valeur de clé.

  Dans l'exemple de code suivant, le chemin d'accès défini pour l'emplacement de l'image est le dossier Mes documents. La plupart des ordinateurs exécutant le système d'exploitation Windows disposent, en effet, de ce dossier. Le choix de cet emplacement permet également aux utilisateurs disposant de niveaux d'accès minimaux au système d'exécuter l'application avec plus de sécurité. L'exemple de code suivant requiert un formulaire auquel un contrôle ImageList a été ajouté.

  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);
}

Pour supprimer toutes les images par programme

• Utilisez la méthode Remove pour supprimer une image.

  - ou -

  Utilisez la méthode Clear pour effacer toutes les images de la liste.

  ' 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();

Pour supprimer des images par clé

• Utilisez la méthode RemoveByKey pour supprimer une image par sa clé.

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

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

Voir aussi

Référence

Vue d'ensemble du composant ImageList (Windows Forms)

Autres ressources

ImageList, composant (Windows Forms)

Images, bitmaps et métafichiers