PictureBoxSizeMode PictureBoxSizeMode PictureBoxSizeMode PictureBoxSizeMode Enum


指定图像在 PictureBox 中的定位方式。Specifies how an image is positioned within a PictureBox.

public enum class PictureBoxSizeMode
public enum PictureBoxSizeMode
type PictureBoxSizeMode = 
Public Enum PictureBoxSizeMode


AutoSize AutoSize AutoSize AutoSize 2

调整 PictureBox 大小,使其等于所包含的图像大小。The PictureBox is sized equal to the size of the image that it contains.

CenterImage CenterImage CenterImage CenterImage 3

如果 PictureBox 比图像大,则图像将居中显示。The image is displayed in the center if the PictureBox is larger than the image. 如果图像比 PictureBox 大,则图片将居于 PictureBox 中心,而外边缘将被剪裁掉。If the image is larger than the PictureBox, the picture is placed in the center of the PictureBox and the outside edges are clipped.

Normal Normal Normal Normal 0

图像被置于 PictureBox 的左上角。The image is placed in the upper-left corner of the PictureBox. 如果图像比包含它的 PictureBox 大,则该图像将被剪裁掉。The image is clipped if it is larger than the PictureBox it is contained in.

StretchImage StretchImage StretchImage StretchImage 1

PictureBox 中的图像被拉伸或收缩,以适合 PictureBox 的大小。The image within the PictureBox is stretched or shrunk to fit the size of the PictureBox.

Zoom Zoom Zoom Zoom 4

图像大小按其原有的大小比例被增加或减小。The size of the image is increased or decreased maintaining the size ratio.


下面的代码示例演示SizeMode属性的用法。The following code example demonstrates the use of the SizeMode property. 若要运行此示例, 请将以下代码粘贴到 Windows 窗体中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()

    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.Run(New Form1())
End Sub

Private Sub InitializePictureBoxAndButton()

    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


使用此枚举的成员可设置的SizeMode PictureBox属性的值。Use the members of this enumeration to set the value of the SizeMode property of the PictureBox.