PictureBox.Image Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define a imagem exibida por PictureBox.

public:
 property System::Drawing::Image ^ Image { System::Drawing::Image ^ get(); void set(System::Drawing::Image ^ value); };

public System.Drawing.Image Image { get; set; }

[System.ComponentModel.Bindable(true)]
public System.Drawing.Image Image { get; set; }

member this.Image : System.Drawing.Image with get, set

[<System.ComponentModel.Bindable(true)>]
member this.Image : System.Drawing.Image with get, set

Public Property Image As Image

Valor da propriedade

Image

O Image a ser exibido.

Atributos

BindableAttribute

Exemplos

O exemplo de código a seguir demonstra como criar um bitmap no runtime e exibi-lo em um PictureBox definindo a Image propriedade. Para executar este exemplo, cole-o em um formulário de Windows e chame CreateBitmapAtRuntime do construtor do formulário.

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;
}

Private pictureBox1 As New PictureBox()

Public Sub CreateBitmapAtRuntime() 
    pictureBox1.Size = New Size(210, 110)
    Me.Controls.Add(pictureBox1)
    
    
    Dim flag As New Bitmap(200, 100)
    Dim flagGraphics As Graphics = Graphics.FromImage(flag)
    Dim red As Integer = 0
    Dim white As Integer = 11
    While white <= 100
        flagGraphics.FillRectangle(Brushes.Red, 0, red, 200, 10)
        flagGraphics.FillRectangle(Brushes.White, 0, white, 200, 10)
        red += 20
        white += 20
    End While
    pictureBox1.Image = flag

End Sub

Comentários

A Image propriedade é definida como a Image exibir. Você pode fazer isso em tempo de design ou em tempo de execução.

Observação

Se você quiser usar a mesma imagem em vários PictureBox controles, crie um clone da imagem para cada PictureBox. Acessar a mesma imagem de vários controles faz com que ocorra uma exceção.

Confira também

• SizeMode