PictureBox.SizeMode 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

指示如何显示图像。

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

PictureBoxSizeMode 值之一。 默认值为 Normal。

例外

InvalidEnumArgumentException

分配的值不是 PictureBoxSizeMode 值之一。

示例

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

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 枚举。

默认情况下，在 Normal 模式下，该 Image 位置位于左上角 PictureBox，图像的任何部分因剪裁过 PictureBox 大而过大。 StretchImage使用该值会导致图像拉伸或收缩以适应 PictureBox。 Zoom使用该值会导致图像拉伸或缩小以适应 ;PictureBox但是，原始图像中的纵横比保持不变。

AutoSize使用该值会导致控件调整大小以始终适合图像。 CenterImage使用该值会导致图像在工作区中居中。

另请参阅

• Image
• PictureBoxSizeMode