Compartilhar via

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

  • Artigo

Se você usar o Windows Forms PictureBox controle em um formulário, você pode definir a SizeMode propriedade nele para:

  • Alinhar canto superior esquerdo a imagem com o canto superior esquerdo do controle.

  • Centralizar a imagem dentro do controle

  • Ajustar o tamanho do controle para ajustar a imagem que ele exibe.

  • Alongar qualquer imagem para ajustar o controle exibe

Alongar uma imagem (especialmente um formato de bitmap) pode produzir uma perda na qualidade da imagem. Metarquivos, que são listas de instruções de gráficos para desenho de imagens em tempo de execução, são mais adequados para o alongamento de bitmaps são.

Para definir a propriedade SizeMode em tempo de execução

  • Set SizeMode to Normal (the default), AutoSize, CenterImage, or StretchImage. Normalsignifica que a imagem é colocada no canto superior esquerdo do controle; Se a imagem for maior do que o controle, suas bordas direita e inferiores são recortadas. CenterImagesignifica que a imagem é centralizada dentro do controle; Se a imagem for maior do que o controle, a bordas externas da imagem são cortadas. AutoSizesignifica que o tamanho do controle é ajustado para o tamanho da imagem. StretchImageé o inverso e significa que o tamanho da imagem é ajustado para o tamanho do controle.

    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 StretchPic()
   ' Stretch the picture to fit the control.
   PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage
   ' Load the picture into the control.
   ' 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 StretchPic(){
   // Stretch the picture to fit the control.
   PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
   // Load the picture into the control.
   // 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 StretchPic(){
   // Stretch the picture to fit the control.
   pictureBox1.set_SizeMode(PictureBoxSizeMode.StretchImage);
   // Load the picture into the control.
   // You should replace "image.gif" in the sample below 
   // with an icon of your own choosing.
   pictureBox1.set_Image(Image.FromFile
   (System.Environment.GetFolderPath
   (System.Environment.SpecialFolder.Personal)
   + "\\Image.gif"));
}

    private:
   void StretchPic()
   {
      // Stretch the picture to fit the control.
      pictureBox1->SizeMode = PictureBoxSizeMode::StretchImage;
      // Load the picture into the control.
      // 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"));
   }

Consulte também

Tarefas

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

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

Referência

PictureBox

Visão geral do controle PictureBox (Windows Forms)

Outros recursos

Controle PictureBox (Windows Forms)