Partilhar via


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

Você pode conjunto programaticamente a imagem exibida por um Windows Forms PictureBox controle.

Para conjunto uma figura através de programação

  • conjunto o Image propriedade usando o FromFile método para o Image classe.

    No exemplo abaixo, o caminho conjunto para o local da imagem é a pasta Meus documentos.Isso é concluído, pois você pode assumir que a maioria dos computadores que executam o Windows inclua este diretório.Isso também permite que os usuários com níveis de acesso de sistema mínima executar o aplicativo com segurança.O exemplo a seguir supõe que 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 desmarcar um elemento gráfico

  • Primeiro, liberar a memória que está sendo usada pela imagem e, em seguida, desmarcar o elemento gráfico.Coleta de lixo liberará a memória mais tarde se gerenciamento de memória se tornar 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ção:

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

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

Consulte também

Tarefas

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

Como: Modificar o dimensionar ou posicionamento de um imagem em time de execução (Windows Forms)

Referência

Visão geral do controle PictureBox (Windows Forms)

PictureBox

Image.FromFile

Outros recursos

PictureBox controle (Windows Forms)