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

Article
08/21/2008

Mise à jour : novembre 2007

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.

Remarque :
Lorsque vous supprimez des images, vérifiez que la propriété ImageIndex de tous les contrôles associés est toujours valide.

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
```

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

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")

Voir aussi

Référence

Vue d'ensemble du composant ImageList (Windows Forms)

Autres ressources

ImageList, composant (Windows Forms)

Images, bitmaps et métafichiers

Partager via