PictureBox.SizeMode 屬性

定義

指示如何顯示影像。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

屬性值

其中一個 PictureBoxSizeMode 值。One of the PictureBoxSizeMode values. 預設為 NormalThe default is Normal.

例外狀況

所指派的值不是其中一個 PictureBoxSizeMode 值。The value assigned is not one of the PictureBoxSizeMode values.

範例

下列程式碼範例示範如何使用 SizeMode 屬性。The following code example demonstrates the use of the SizeMode property. 若要執行此範例,請將下列程式碼貼入 Windows Form,並從表單的函式或載入事件處理方法呼叫 InitializePictureBoxAndButton 方法。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

備註

這個屬性的有效值是取自 PictureBoxSizeMode 列舉。Valid values for this property are taken from the PictureBoxSizeMode enumeration.

根據預設,在 Normal 模式中,Image 位於 PictureBox的左上角,而影像中任何對 PictureBox 太大的部分則會裁剪。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. 使用 StretchImage 值會使影像延展或縮小,以符合 PictureBoxUsing the StretchImage value causes the image to stretch or shrink to fit the PictureBox. 使用 Zoom 值會使影像延伸或縮小,以符合 PictureBox;不過,會保留原始中的長寬比。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.

使用 AutoSize 值會導致控制項調整大小,使其永遠符合影像。Using the AutoSize value causes the control to resize to always fit the image. 使用 CenterImage 值會導致影像置中在工作區中。Using the CenterImage value causes the image to be centered in the client area.

適用於

另請參閱