PictureBox.SizeMode Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gibt an, wie das Bild angezeigt wird.

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

Eigenschaftswert

PictureBoxSizeMode

Einer der PictureBoxSizeMode-Werte. Der Standardwert ist Normal.

Ausnahmen

InvalidEnumArgumentException

Der zugewiesene Wert ist keiner der PictureBoxSizeMode-Werte.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des SizeMode-Attributs veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Windows Form-Formular ein, und rufen Sie die InitializePictureBoxAndButton -Methode aus dem Konstruktor oder der Load-Event-Behandlungsmethode des Formulars auf.

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

Hinweise

Gültige Werte für diese Eigenschaft werden aus der PictureBoxSizeMode Enumeration übernommen.

Standardmäßig wird im Normal Modus in Image der oberen linken Ecke des PictureBoxpositioniert, und jeder Teil des Bilds, der für zu PictureBox groß ist, wird abgeschnitten. Wenn Sie den StretchImage -Wert verwenden, wird das Bild so gestreckt oder verkleinern, dass es an den PictureBoxpasst. Die Verwendung des Zoom -Werts bewirkt, dass das Bild gestreckt oder verkleinert wird, damit es PictureBoxdem entspricht. Das Seitenverhältnis im Original wird jedoch beibehalten.

Die Verwendung des AutoSize -Werts bewirkt, dass die Größe des Steuerelements so geändert wird, dass es immer an das Bild angepasst wird. Wenn Sie den CenterImage Wert verwenden, wird das Bild im Clientbereich zentriert.

Weitere Informationen

• Image
• PictureBoxSizeMode