Como: Adicionar ou remover imagens com o componente Windows Forms ImageList

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.

Para adicionar imagens programaticamente

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

  No exemplo de código a seguir, o caminho definido para o local da imagem é a pasta My Documents. Esse local é usado porque você pode supor que a maioria dos computadores que executam o sistema operacional Windows incluirá essa pasta. Escolher esse local também permite que os usuários que têm níveis mínimos de acesso ao sistema executem o aplicativo com mais segurança. O exemplo de código a seguir requer que você tenha um formulário com um controle ImageList 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 Add da propriedade Images da lista de imagens que usa um valor de chave.

  No exemplo de código a seguir, o caminho definido para o local da imagem é a pasta My Documents. Esse local é usado porque você pode supor que a maioria dos computadores que executam o sistema operacional Windows incluirá essa pasta. Escolher esse local também permite que os usuários que têm níveis mínimos de acesso ao sistema executem o aplicativo com mais segurança. O exemplo de código a seguir requer que você tenha um formulário com um controle ImageList 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 programaticamente

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

  ,-ou-

  Use o método Clear 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 método RemoveByKey para remover uma única imagem usando a 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");

Ver também

• Componente de ImageList
• Visão Geral do Componente ImageList
• Imagens, Bitmaps e Metarquivos