PictureBoxSizeMode Enumeração

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll
Origem:
PictureBoxSizeMode.cs
Origem:
PictureBoxSizeMode.cs
Origem:
PictureBoxSizeMode.cs
Origem:
PictureBoxSizeMode.cs
Origem:
PictureBoxSizeMode.cs

Especifica como uma imagem está posicionada dentro de um PictureBox.

public enum class PictureBoxSizeMode
public enum PictureBoxSizeMode
type PictureBoxSizeMode = 
Public Enum PictureBoxSizeMode
Herança
Object
ValueType
Enum
PictureBoxSizeMode

Campos

Name Valor Description
Normal 0

A imagem está colocada no canto superior esquerdo do PictureBox. A imagem é recortada se for maior do que a PictureBox que está contida.
StretchImage 1

A imagem dentro do PictureBox é esticada ou encolhida para se ajustar ao tamanho do PictureBox.
AutoSize 2

O PictureBox tem o tamanho igual ao tamanho da imagem que contém.
CenterImage 3

A imagem é exibida no centro se for PictureBox maior do que a imagem. Se a imagem for maior do que o PictureBox, a imagem é colocada no centro do PictureBox e as bordas exteriores são cortadas.
Zoom 4

O tamanho da imagem é aumentado ou diminuído, mantendo a proporção de tamanho.

Exemplos

O seguinte exemplo de código demonstra a utilização da SizeMode propriedade. Para executar este exemplo, cole o código seguinte num formulário Windows e chame o método InitializePictureBoxAndButton do construtor do formulário ou do método de tratamento de eventos de carga.

PictureBox PictureBox1 = new PictureBox();
Button Button1 = new Button();

private void InitializePictureBoxAndButton()
{

    this.Controls.Add(PictureBox1);
    this.Controls.Add(Button1);
    Button1.Location = new Point(175, 20);
    Button1.Text = "Stretch";
    Button1.Click += new EventHandler(Button1_Click);

    // Set the size of the PictureBox control.
    this.PictureBox1.Size = new System.Drawing.Size(140, 140);

    //Set the SizeMode to center the image.
    this.PictureBox1.SizeMode = PictureBoxSizeMode.CenterImage;

    // Set the border style to a three-dimensional border.
    this.PictureBox1.BorderStyle = BorderStyle.Fixed3D;

    // Set the image property.
    this.PictureBox1.Image = new Bitmap(typeof(Button), "Button.bmp");
}

private void Button1_Click(System.Object sender, System.EventArgs e)
{
    // Set the SizeMode property to the StretchImage value.  This
    // will enlarge the image as needed to fit into
    // the PictureBox.
    PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
}

Dim PictureBox1 As New PictureBox()
Dim WithEvents Button1 As New Button

<STAThread()> _
Public Shared Sub Main()
    Application.EnableVisualStyles()
    Application.Run(New Form1())
End Sub

Private Sub InitializePictureBoxAndButton()

    Me.Controls.Add(PictureBox1)
    Me.Controls.Add(Button1)
    Button1.Location = New Point(175, 20)
    Button1.Text = "Stretch"

    ' Set the size of the PictureBox control.
    Me.PictureBox1.Size = New System.Drawing.Size(140, 140)

    'Set the SizeMode to center the image.
    Me.PictureBox1.SizeMode = PictureBoxSizeMode.CenterImage

    ' Set the border style to a three-dimensional border.
    Me.PictureBox1.BorderStyle = BorderStyle.Fixed3D

    ' Set the image property.
    Me.PictureBox1.Image = New Bitmap(GetType(Button), "Button.bmp")
End Sub

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click
    ' Set the SizeMode property to the StretchImage value.  This
    ' will enlarge the image as needed to fit into
    ' the PictureBox.
    PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage
End Sub

Observações

Use os membros desta enumeração para definir o valor da SizeMode propriedade do PictureBox.

Aplica-se a