PictureBox.SizeMode Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

PictureBox.cs

Určuje, jak se obrázek zobrazí.

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

Hodnota vlastnosti

PictureBoxSizeMode

Jedna z PictureBoxSizeMode hodnot. Výchozí hodnota je Normal.

Výjimky

InvalidEnumArgumentException

Přiřazená hodnota není jednou z PictureBoxSizeMode hodnot.

Příklady

Následující příklad kódu ukazuje použití SizeMode vlastnosti. Pokud chcete tento příklad spustit, vložte do formuláře Windows Následující kód a volejte metodu InitializePictureBoxAndButton z konstruktoru formuláře nebo metody zpracování událostí Load.

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

Poznámky

Platné hodnoty pro tuto vlastnost jsou převzaty z výčtu PictureBoxSizeMode .

Ve výchozím nastavení je v Normal režimu umístěn v levém horním rohu PictureBoxa jakákoli část obrázku, Image která je pro oříznutáPictureBox. StretchImage Použití hodnoty způsobí, že se obrázek roztáhne nebo zmenší tak, aby se přizpůsobil PictureBox. Zoom Použití hodnoty způsobí roztažení nebo zmenšení obrázku tak, aby se vešel do PictureBox; poměr stran v originálu je však zachován.

AutoSize Použití hodnoty způsobí, že ovládací prvek změní velikost tak, aby vždy odpovídal obrázku. CenterImage Použití hodnoty způsobí, že se image zacentruje do klientské oblasti.

Viz také

• Image
• PictureBoxSizeMode