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

Artigo
12/17/2024

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 propriedade ImageIndex de quaisquer controles associados ainda é válida.

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 ImageList
Visão geral do componente ImageList
Imagens, Bitmaps e Metarquivos

Partilhar via