Compartilhar via


Como: Conjunto de imagens em tempo de execução (Windows Forms)

Programaticamente, você pode definir a imagem exibida pelo Windows Forms PictureBox de controle.

Para definir uma imagem programaticamente

  • Definir o Image propriedade usando o FromFile método o Image classe.

    No exemplo abaixo, o caminho definido para o local da imagem é a pasta Meus documentos. Isso é feito, pois você pode assumir que a maioria dos computadores que executam o sistema operacional Windows inclua este diretório. Isso também permite que os usuários com níveis de acesso do sistema mínimo com segurança, execute o aplicativo. O exemplo a seguir supõe um formulário com um PictureBox controle já adicionado.

    Private Sub LoadNewPict()
       ' You should replace the bold image 
       ' in the sample below with an icon of your own choosing.
       PictureBox1.Image = Image.FromFile _
       (System.Environment.GetFolderPath _
       (System.Environment.SpecialFolder.Personal) _
       & "\Image.gif")
    End Sub
    
    private void LoadNewPict(){
       // You should replace the bold image 
       // in the sample below with an icon of your own choosing.
       // Note the escape character used (@) when specifying the path.
       pictureBox1.Image = Image.FromFile
       (System.Environment.GetFolderPath
       (System.Environment.SpecialFolder.Personal)
       + @"\Image.gif");
    }
    
    private void LoadNewPict(){
       // You should replace the bold image 
       // in the sample below with an icon of your own choosing.
       pictureBox1.get_Image().FromFile
       (System.Environment.GetFolderPath
       (System.Environment.SpecialFolder.Personal)
       + "\\Image.gif");
    
    private:
       void LoadNewPict()
       {
          // You should replace the bold image 
          // in the sample below with an icon of your own choosing.
          pictureBox1->Image = Image::FromFile(String::Concat(
             System::Environment::GetFolderPath(
             System::Environment::SpecialFolder::Personal),
             "\\Image.gif"));
       }
    

Para limpar um elemento gráfico

  • Primeiro, liberar a memória que está sendo usada pela imagem e, em seguida, desmarque o elemento gráfico. Coleta de lixo irá liberar a memória mais tarde se o gerenciamento de memória se torna um problema.

    If Not (PictureBox1.Image Is Nothing) Then
       PictureBox1.Image.Dispose()
       PictureBox1.Image = Nothing
    End If
    
    if (pictureBox1.Image != null) 
    {
       pictureBox1.Image.Dispose();
       pictureBox1.Image = null;
    }
    
    if (pictureBox1->Image != nullptr)
    {
       pictureBox1->Image->Dispose();
       pictureBox1->Image = nullptr;
    }
    
    ObservaçãoObservação

    Para obter mais informações sobre por que você deve usar o Dispose método dessa maneira, consulte Limpeza de recursos não gerenciados.

    Esse código limpará a imagem, mesmo se um elemento gráfico que foi carregado no controle em tempo de design.

Consulte também

Tarefas

Como: Carregar uma imagem usando o Designer (Windows Forms)

Como: Modificar o tamanho ou posicionamento de uma imagem em tempo de execução (Windows Forms)

Referência

Visão geral do controle PictureBox (Windows Forms)

PictureBox

Image.FromFile

Outros recursos

Controle PictureBox (Windows Forms)