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

Definizione

Indica come viene visualizzata l'immagine.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

Valore della proprietà

Uno dei valori di PictureBoxSizeMode.One of the PictureBoxSizeMode values. Il valore predefinito è Normal.The default is Normal.

Eccezioni

Esempi

Nell'esempio di codice riportato di seguito viene illustrato SizeMode l'utilizzo della proprietà.The following code example demonstrates the use of the SizeMode property. Per eseguire questo esempio, incollare il codice seguente in un Windows Form e chiamare il InitializePictureBoxAndButton metodo dal costruttore del form o dal metodo di gestione degli eventi di caricamento.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

Commenti

I valori validi per questa proprietà sono ricavati dall' PictureBoxSizeMode enumerazione.Valid values for this property are taken from the PictureBoxSizeMode enumeration.

Per impostazione predefinita, Normal la Image modalità è posizionata nell'angolo superiore sinistro dell'oggetto PictureBoxe qualsiasi parte dell'immagine troppo grande per PictureBox è ritagliata.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. Se si StretchImage usa il valore PictureBox, l'immagine si estende o si compatta per adattarla a.Using the StretchImage value causes the image to stretch or shrink to fit the PictureBox. L'utilizzo Zoom del valore fa sì che l'immagine venga allungata o compattata in modo da PictureBoxadattarsi a; tuttavia, le proporzioni nell'oggetto originale vengono mantenute.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.

L'utilizzo AutoSize del valore determina il ridimensionamento del controllo in modo da adattarsi sempre all'immagine.Using the AutoSize value causes the control to resize to always fit the image. L'utilizzo CenterImage del valore determina il centramento dell'immagine nell'area client.Using the CenterImage value causes the image to be centered in the client area.

Si applica a

Vedi anche