PictureBox.SizeMode PictureBox.SizeMode PictureBox.SizeMode PictureBox.SizeMode Property

Definição

Indica como a imagem é exibida.Indicates how the image is displayed.

public:
 property System::Windows::Forms::PictureBoxSizeMode SizeMode { System::Windows::Forms::PictureBoxSizeMode get(); void set(System::Windows::Forms::PictureBoxSizeMode value); };
public System.Windows.Forms.PictureBoxSizeMode SizeMode { get; set; }
member this.SizeMode : System.Windows.Forms.PictureBoxSizeMode with get, set
Public Property SizeMode As PictureBoxSizeMode

Valor da propriedade

Exceções

Exemplos

O exemplo de código a seguir demonstra o uso SizeMode da propriedade.The following code example demonstrates the use of the SizeMode property. Para executar este exemplo, Cole o código a seguir em um formulário do Windows e InitializePictureBoxAndButton chame o método do construtor do formulário ou do método de manipulação de eventos de carga.To run this example, paste the following code into a Windows Form and call the InitializePictureBoxAndButton method from the form's constructor or Load-event handling method.

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

Comentários

Os PictureBoxSizeMode valores válidos para essa propriedade são obtidos da enumeração.Valid values for this property are taken from the PictureBoxSizeMode enumeration.

Por padrão, no Normal modo, o Image é posicionado no canto superior esquerdo do PictureBoxe qualquer parte da imagem que é muito grande para o PictureBox é recortada.By default, in Normal mode, the Image is positioned in the upper-left corner of the PictureBox, and any part of the image that is too big for the PictureBox is clipped. O uso StretchImage do valor faz com que a imagem seja ampliada ou PictureBoxreduzida para se ajustar ao.Using the StretchImage value causes the image to stretch or shrink to fit the PictureBox. O uso Zoom do valor faz com que a imagem seja ampliada ou reduzida para PictureBoxse ajustar ao; no entanto, a taxa de proporção no original é mantida.Using the Zoom value causes the image to be stretched or shrunk to fit the PictureBox; however, the aspect ratio in the original is maintained.

O uso AutoSize do valor faz com que o controle seja redimensionado para sempre se ajustar à imagem.Using the AutoSize value causes the control to resize to always fit the image. O uso CenterImage do valor faz com que a imagem seja centralizada na área do cliente.Using the CenterImage value causes the image to be centered in the client area.

Aplica-se a

Veja também