1 out of 1 rated this helpful - Rate this topic

PictureBox.SizeMode Property

Indicates how the image is displayed.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

[LocalizableAttribute(true)] 
public PictureBoxSizeMode SizeMode { get; set; }
/** @property */
public PictureBoxSizeMode get_SizeMode ()

/** @property */
public void set_SizeMode (PictureBoxSizeMode value)

public function get SizeMode () : PictureBoxSizeMode

public function set SizeMode (value : PictureBoxSizeMode)

Not applicable.

Property Value

One of the PictureBoxSizeMode values. The default is Normal.
Exception typeCondition

InvalidEnumArgumentException

The value assigned is not one of the PictureBoxSizeMode values.

Valid values for this property are taken from the PictureBoxSizeMode enumeration. By default, in Normal mode, the Image is positioned in the upper-left corner of the PictureBox, and any part of the image too big for the PictureBox is clipped. Using the StretchImage value causes the image to stretch to fit the PictureBox.

Using the AutoSize value causes the control to resize to always fit the image. Using the CenterImage value causes the image to be centered in the client area.

The following code example demonstrates the use of the SizeMode property. 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;
}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.