SimpleShape.BackgroundImage (Propiedad)

Artículo
11/02/2012

Obtiene o establece la imagen mostrada en la forma.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
<BrowsableAttribute(True)> _
Public Property BackgroundImage As Image

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

[BrowsableAttribute(true)]
public:
property Image^ BackgroundImage {
    Image^ get ();
    void set (Image^ value);
}

[<BrowsableAttribute(true)>]
member BackgroundImage : Image with get, set

function get BackgroundImage () : Image
function set BackgroundImage (value : Image)

Valor de propiedad

Tipo: System.Drawing.Image
Image que representa la imagen para mostrar en segundo plano de la forma.

Comentarios

Utilice la propiedad de BackgroundImage para colocar una imagen gráfica sobre una forma.

[!NOTA]

Estableciendo la propiedad de BackgroundImage reemplaza cualquier valor para BackColor, BackStyle, FillColor, FillGradientColor, FillGradientStyle, y las propiedades de FillStyle .

Notas para los herederos

Al reemplazar la propiedad de BackgroundImage en una clase derivada, utilice la propiedad de BackgroundImage de la clase base para extender la implementación base.Si no, deberá proporcionarse toda la implementación.No es necesario reemplazar los descriptores de acceso get y set de la propiedad de BackgroundImage ; puede reemplazar solo uno si es necesario.

Ejemplos

El ejemplo siguiente muestra cómo utilizar las propiedades de BackgroundImage y de BackgroundImageLayout para mostrar una imagen en una forma.Este ejemplo requiere tener un control de OvalShape denominado OvalShape1 en un formulario y que el proyecto contiene un recurso de imagen denominado Image1.

Private Sub Form1_Load() Handles MyBase.Load
    ' Assign an image resource.
    OvalShape1.BackgroundImage = My.Resources.Image1
    ' Resize the image to fit the oval.
    OvalShape1.BackgroundImageLayout = ImageLayout.Stretch
End Sub

private void form1_Load(System.Object sender, System.EventArgs e)
{
    // Assign an image resource.
    ovalShape1.BackgroundImage = SimpleShapeBackGroundImageCS.Properties.Resources.Image1;
    // Resize the image to fit the oval.
    ovalShape1.BackgroundImageLayout = ImageLayout.Stretch;
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.