Classe PictureBox

Normalmente o PictureBox é usado para exibir elementos gráficos de um bitmap, metarquivo, ícone, arquivo JPEG, GIF ou PNG.

conjunto o Image propriedade para o Image você deseja exibir, em time de design ou em time de execução. Alternativamente, você pode especificar a imagem através da propriedade ImageLocation e carregar a imagem de forma síncrona usando o método Load ou de forma assíncrona usando o método LoadAsync.

Observação:
Se você deseja usar a mesma imagem em vários PictureBox controles, criar um clone da imagem para cada PictureBox. Acessando a mesma imagem de vários controles causa a ocorrência de uma exceção.

The SizeMode propriedade, que é definida como valores de PictureBoxSizeMode enumeração, controla o recorte e o posicionamento da imagem na área de exibição. Você pode alterar o tamanho da área de exibição em tempo de execução através da propriedade ClientSize.

Por padrão, o controle PictureBox é exibido sem quaisquer bordas. Você pode fornecer uma borda tridimensional ou padrão usando o BorderStyle caixa de propriedade para distinguir a imagem do restante do formulário, mesmo não se contiver nenhuma imagem. O PictureBox é não é um controle selecionável, o que significa que ele não pode receber foco de entrada.

O exemplo de código a seguir ilustra como você pode definir uma imagem e redimensionar a área de exibição da caixa de imagem. Este exemplo requer que ShowMyImage seja chamado num formulário existente, e que o namespace System.Drawing tenha sido adicionado ao código-fonte do seu formulário.

private Bitmap MyImage ;
publicvoid ShowMyImage(String fileToDisplay, int xSize, int ySize)
{
   // Sets up an image object to be displayed.if (MyImage != null)
   {
      MyImage.Dispose();
   }

   // Stretches the image to fit the pictureBox.
   pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage ;
   MyImage = new Bitmap(fileToDisplay);
   pictureBox1.ClientSize = new Size(xSize, ySize);
   pictureBox1.Image = (Image) MyImage ;
}

private Bitmap myImage;
public void ShowMyImage(String fileToDisplay, int xSize, int ySize)
{
    // Sets up an image object to be displayed.
    if (myImage != null) {
        myImage.Dispose();
    }

    // Stretches the image to fit the pictureBox.
    pictureBox1.set_SizeMode(PictureBoxSizeMode.StretchImage);
    myImage = new Bitmap(fileToDisplay);
    pictureBox1.set_ClientSize(new Size(xSize, ySize));
    pictureBox1.set_Image(myImage);
} //ShowMyImage

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

.NET Framework

.NET Compact Framework

Referência

Outros recursos