Procedura: aggiungere o rimuovere immagini tramite il componente ImageList Windows Form

Articolo
09/12/2008

Aggiornamento: novembre 2007

Il componente ImageList Windows Form viene solitamente compilato mediante immagini prima di essere associato a un controllo. Tuttavia, è possibile aggiungere e rimuovere le immagini dopo aver associato l'elenco a un controllo.

Nota:
Se si rimuovono immagini, verificare che la proprietà ImageIndex di eventuali controlli associati continui a essere valida.

Per aggiungere le immagini a livello di codice

Utilizzare il metodo Add della proprietà Images dell'elenco immagini.

Nell'esempio di codice riportato di seguito il percorso impostato per la posizione dell'immagine corrisponde alla cartella Documenti. Questo percorso viene utilizzato per il fatto che si suppone che questa directory sia presente sulla maggior parte dei computer con sistema operativo Windows. Questa scelta consente inoltre agli utenti con livelli minimi di accesso al sistema di eseguire l'applicazione in modo più sicuro. Per l'esempio è necessario un form a cui sia già stato aggiunto un controllo ImageList.

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

Per aggiungere immagini con un valore di chiave

Utilizzare uno dei metodi Add della proprietà Images dell'elenco immagini che accetta un valore di chiave.

Nell'esempio di codice riportato di seguito il percorso impostato per la posizione dell'immagine corrisponde alla cartella Documenti. Questo percorso viene utilizzato per il fatto che si suppone che questa directory sia presente sulla maggior parte dei computer con sistema operativo Windows. Questa scelta consente inoltre agli utenti con livelli minimi di accesso al sistema di eseguire l'applicazione in modo più sicuro. Per l'esempio è necessario un form a cui sia già stato aggiunto un controllo ImageList.
```
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
```

Per rimuovere tutte le immagini a livello di codice

Utilizzare il metodo Remove per rimuovere una singola immagine

oppure

Utilizzare il metodo Clear per eliminare tutte le immagini nell'elenco immagini.
```
' Removes the first image in the image list
ImageList1.Images.Remove(myImage)
' Clears all images in the image list
ImageList1.Images.Clear()
```

Per rimuovere immagini in base alla chiave

Utilizzare il metodo RemoveByKey per rimuovere una singola immagine in base alla propria chiave.
```
' Removes the image named "myPhoto" from the list.
ImageList1.Images.RemoveByKey("myPhoto")
```

Vedere anche

Riferimenti

Cenni preliminari sul componente ImageList (Windows Form)

Altre risorse

Componente ImageList (Windows Form)

Immagini, bitmap e metafile

Condividi tramite