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

PictureBoxSizeMode 值之一。One of the PictureBoxSizeMode values. 默认值为 NormalThe default is Normal.

例外

分配的值不是 PictureBoxSizeMode 值之一。The value assigned is not one of the PictureBoxSizeMode values.

示例

下面的代码示例演示属性的用法 SizeModeThe 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()
{

    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.

适用于

另请参阅