PictureBox.Image Property

 

Gets or sets the image that is displayed by PictureBox.

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

[BindableAttribute(true)]
public Image Image { get; set; }

Property Value

Type: System.Drawing.Image

The Image to display.

The Image property is set to the Image to display. You can do this either at design time or at run time.

System_CAPS_noteNote

If you want to use the same image in multiple PictureBox controls, create a clone of the image for each PictureBox. Accessing the same image from multiple controls causes an exception to occur.

The following code example demonstrates how to create a bitmap at runtime and display it in a PictureBox by setting the Image property. To run this example, paste it into a Windows Form and call CreateBitmapAtRuntime from the form's constructor.

PictureBox pictureBox1 = new PictureBox();
public void CreateBitmapAtRuntime()
{
    pictureBox1.Size = new Size(210, 110);
    this.Controls.Add(pictureBox1);

    Bitmap flag = new Bitmap(200, 100);
    Graphics flagGraphics = Graphics.FromImage(flag);
    int red = 0;
    int white = 11;
    while (white <= 100) {
        flagGraphics.FillRectangle(Brushes.Red, 0, red, 200,10);
        flagGraphics.FillRectangle(Brushes.White, 0, white, 200, 10);
        red += 20;
        white += 20;
    }
    pictureBox1.Image = flag;

}

.NET Framework
Available since 1.1
Return to top
Show: