PictureBox.SizeMode Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Indica cómo se muestra la imagen.

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 de propiedad

PictureBoxSizeMode

Uno de los valores de PictureBoxSizeMode. De manera predeterminada, es Normal.

Excepciones

InvalidEnumArgumentException

El valor asignado no es uno de los valores de PictureBoxSizeMode.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de la SizeMode propiedad . Para ejecutar este ejemplo, pegue el código siguiente en un formulario Windows Forms y llame al InitializePictureBoxAndButton método desde el constructor del formulario o el método de control de eventos load-event.

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

Comentarios

Los valores válidos para esta propiedad se toman de la PictureBoxSizeMode enumeración .

De forma predeterminada, en Normal el modo , Image se coloca en la esquina superior izquierda de PictureBox, y cualquier parte de la imagen demasiado grande para se PictureBox recorta. El uso del StretchImage valor hace que la imagen se ajuste o reduzca para ajustarse PictureBoxa . Al usar el Zoom valor, la imagen se estira o se reduce para ajustarse PictureBoxa ; sin embargo, se mantiene la relación de aspecto en el original.

El uso del AutoSize valor hace que el control cambie el tamaño para ajustarse siempre a la imagen. El uso del CenterImage valor hace que la imagen se centre en el área de cliente.

Consulte también

• Image
• PictureBoxSizeMode