SimpleShape.BackgroundImage (Propiedad)

Artículo
09/04/2008

Actualización: noviembre 2007

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

<BrowsableAttribute(True)> _
Public Property BackgroundImage As Image

Dim instance As SimpleShape
Dim value As Image

value = instance.BackgroundImage

instance.BackgroundImage = value

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

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

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

Valor de propiedad

Tipo: System.Drawing.Image

Image que representa la imagen que se va a mostrar en el fondo de la forma.

Comentarios

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

Nota:
Al establecer la propiedad BackgroundImage, se invalida cualquier valor para las propiedades BackColor, BackStyle, FillColor, FillGradientColor y FillStyle y FillGradientStyle.

Notas para los herederos:

Cuando se invalida la propiedad BackgroundImage en una clase derivada, hay que utilizar la propiedad BackgroundImage de la clase base para extender la implementación base. Si no, deberá proporcionarse toda la implementación. No es necesario invalidar ambos descriptores de acceso get y set de la propiedad BackgroundImage; se puede invalidar sólo uno, si es necesario.

Ejemplos

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

Private Sub Form1_Load(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) 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;
}

Permisos

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.