Como adicionar ou remover imagens com o componente ImageList dos Windows Forms

  • Artigo

O componente Windows Forms ImageList normalmente é preenchido com imagens antes de ser associado a um controle. No entanto, você pode adicionar e remover imagens depois de associar a lista de imagens a um controle.

Observação

Ao remover imagens, verifique se a ImageIndex propriedade de quaisquer controles associados ainda é válida.

Para adicionar imagens de forma programática

  • Use o Add método da propriedade da lista de Images imagens.

    No exemplo de código a seguir, o caminho definido para o local da imagem é a pasta Meus documentos. Esse local é usado porque você pode supor que a maioria dos computadores que executam o sistema operacional Windows inclui essa pasta. Escolher esse local também permite que os usuários que têm níveis de acesso ao sistema mínimos executem com mais segurança o aplicativo. O exemplo de código a seguir requer que você tenha um formulário com um ImageList controle já adicionado.

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

Para adicionar imagens com um valor de chave.

  • Use um dos métodos da Images propriedade da lista de imagens que usa um valor de Add chave.

    No exemplo de código a seguir, o caminho definido para o local da imagem é a pasta Meus documentos. Esse local é usado porque você pode supor que a maioria dos computadores que executam o sistema operacional Windows inclui essa pasta. Escolher esse local também permite que os usuários que têm níveis de acesso ao sistema mínimos executem com mais segurança o aplicativo. O exemplo de código a seguir requer que você tenha um formulário com um ImageList controle já adicionado.

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

Para remover todas as imagens de forma programática

  • Use o Remove método para remover uma única imagem

    ,-ou-

    Use o Clear método para limpar todas as imagens na lista de imagens.

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

Para remover imagens por chave

  • Use o RemoveByKey método para remover uma única imagem por sua chave.

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

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

Confira também