PictureBoxSizeMode 枚举

定义

指定图像在 PictureBox 中的定位方式。

C#
public enum PictureBoxSizeMode
继承
PictureBoxSizeMode

字段

名称 说明
AutoSize 2

调整 PictureBox 大小,使其等于所包含的图像大小。

CenterImage 3

如果 PictureBox 比图像大,则图像将居中显示。 如果图像比 PictureBox 大,则图片将居于 PictureBox 中心,而外边缘将被剪裁掉。

Normal 0

图像被置于 PictureBox 的左上角。 如果图像比包含它的 PictureBox 大,则该图像将被剪裁掉。

StretchImage 1

PictureBox 中的图像被拉伸或收缩,以适合 PictureBox 的大小。

Zoom 4

图像大小按其原有的大小比例被增加或减小。

示例

下面的代码示例演示如何使用 SizeMode 属性。 若要运行此示例,请将以下代码粘贴到 Windows 窗体中,并从窗体的构造函数或 Load-event 处理方法调用 InitializePictureBoxAndButton 方法。

C#
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;
}

注解

使用此枚举的成员可设置 的 属性PictureBox的值SizeMode

适用于

产品 版本
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9