Como: Definir a imagem exibida por um controle de Windows FormsHow to: Set the image displayed by a Windows Forms control

Vários controles de Windows Forms podem exibir imagens.Several Windows Forms controls can display images. Essas imagens podem ser ícones que esclarecem a finalidade do controle, como um ícone de disquete em um botão que indica o comando salvar.These images can be icons that clarify the purpose of the control, such as a diskette icon on a button denoting the Save command. Como alternativa, os ícones podem ser imagens de plano de fundo para dar ao controle a aparência e o comportamento que você deseja.Alternatively, the icons can be background images to give the control the appearance and behavior you want.

ProgramProgrammatic

Defina a propriedade Image ou BackgroundImage o controle como um objeto do tipo Image.Set the control's Image or BackgroundImage property to an object of type Image. Em geral, você carregará a imagem de um arquivo usando o FromFile método.Generally, you'll be loading the image from a file by using the FromFile method.

No exemplo de código a seguir, o caminho definido para o local da imagem é a pasta minhas imagens .In the following code example, the path set for the location of the image is the My Pictures folder. A maioria dos computadores que executam o sistema operacional Windows inclui esse diretório.Most computers running the Windows operating system include this directory. Isso também permite que os usuários com níveis mínimos de acesso do sistema executem o aplicativo com segurança.This also enables users with minimal system access levels to run the application safely. O exemplo de código a seguir requer que você já tenha um formulário PictureBox com um controle adicionado.The following code example requires that you already have a form with a PictureBox control added.

' Replace the image named below with your own icon.
PictureBox1.Image = Image.FromFile _
   (System.Environment.GetFolderPath _
   (System.Environment.SpecialFolder.MyPictures) _
   & "\Image.gif")
// Replace the image named below with your own icon.
// Note the escape character used (@) when specifying the path.
pictureBox1.Image = Image.FromFile
   (System.Environment.GetFolderPath
   (System.Environment.SpecialFolder.MyPictures)
   + @"\Image.gif");
// Replace the image named below with your own icon.
pictureBox1->Image = Image::FromFile(String::Concat
   (System::Environment::GetFolderPath
   (System::Environment::SpecialFolder::MyPictures),
   "\\Image.gif"));

DesignerDesigner

  1. Na janela Propriedades do Visual Studio, selecione a propriedade Image ou BackgroundImage do controle e, em seguida, selecione as reticências(botão de reticênciasno Visual Studio) para exibir a seleção Caixa de diálogo recurso.In the Properties window of Visual Studio, select the Image or BackgroundImage property of the control, and then select the ellipsis (Ellipsis button in Visual Studio) to display the Select Resource dialog box.

  2. Selecione a imagem que você deseja exibir.Select the image you want to display.

Consulte tambémSee also