PictureBoxSizeMode Enumeration

 

Specifies how an image is positioned within a PictureBox.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public enum class PictureBoxSizeMode

Member nameDescription
AutoSize

The PictureBox is sized equal to the size of the image that it contains.

CenterImage

The image is displayed in the center if the PictureBox is larger than the image. 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

The image is placed in the upper-left corner of the PictureBox. The image is clipped if it is larger than the PictureBox it is contained in.

StretchImage

The image within the PictureBox is stretched or shrunk to fit the size of the PictureBox.

Zoom

The size of the image is increased or decreased maintaining the size ratio.

Use the members of this enumeration to set the value of the SizeMode property of the PictureBox.

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.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: