PictureBox.SizeMode Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Indica come viene visualizzata l'immagine.

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à

PictureBoxSizeMode

Uno dei valori di PictureBoxSizeMode. Il valore predefinito è Normal.

Eccezioni

InvalidEnumArgumentException

Il valore assegnato non è uno dei valori di PictureBoxSizeMode.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso SizeMode della proprietà. Per eseguire questo esempio, incollare il codice seguente in un modulo Windows e chiamare il InitializePictureBoxAndButton metodo dal costruttore del modulo o dal metodo di gestione eventi 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

Commenti

I valori validi per questa proprietà vengono acquisiti dall'enumerazione PictureBoxSizeMode .

Per impostazione predefinita, in Normal modalità, l'oggetto Image viene posizionato nell'angolo superiore sinistro dell'immagine PictureBoxe qualsiasi parte dell'immagine troppo grande per l'oggetto PictureBox viene ritagliata. L'uso del StretchImage valore causa l'estensione o la compattazione dell'immagine per adattarsi a PictureBox. L'uso del Zoom valore determina che l'immagine venga estesa o ridimensionata per adattarsi PictureBoxall'oggetto . Tuttavia, il rapporto di aspetto nell'originale viene mantenuto.

L'uso del AutoSize valore causa il ridimensionamento del controllo per adattarsi sempre all'immagine. L'uso del CenterImage valore causa il centro dell'immagine nell'area client.

Si applica a

Vedi anche