Compartilhar via


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

O Windows Forms ImageList componente geralmente é preenchida com imagens para que ele seja associado a um controle. No entanto, você pode adicionar e remover imagem s depois de associar o imagem lista com um controle.

Observação:

Quando você remove imagens, verifique se a ImageIndex propriedade de quaisquer controles associados é válida ainda.

Para adicionar imagens de forma programática

  • Use o Add método do imagem da lista Images propriedade.

    No exemplo de código a seguir, o caminho definido para o local da imagem é o Meus documentos pasta.Esse local é usado porque você pode assumir que a maioria dos computadores que executam o sistema operacional Windows inclua esta pasta.Escolher este local também permite que os usuários que possuem o sistema mínimo níveis de acesso mais executar o aplicativo com segurança.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 do Add métodos para o imagem da lista Images propriedade que leva um valor de chave.

    No exemplo de código a seguir, o caminho definido para o local da imagem é o Meus documentos pasta.Esse local é usado porque você pode assumir que a maioria dos computadores que executam o sistema operacional Windows inclua esta pasta.Escolher este local também permite que os usuários que possuem o sistema mínimo níveis de acesso mais executar o aplicativo com segurança.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
    

Para remover todas as imagens por programação

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

    , - ou -

    Use o Clear método para desmarcar 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()
    

Para remover imagens pela 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")
    

Consulte também

Referência

ImageList componente visão geral (Windows Forms)

Outros recursos

ImageList componente (Windows Forms)

Imagens, bitmaps e metarquivos