SimpleShape.BackgroundImageLayout (Propiedad)

Artículo
09/04/2008

Actualización: noviembre 2007

Obtiene o establece el diseño de imagen de fondo como se define en la enumeración ImageLayout.

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

Sintaxis

<BrowsableAttribute(True)> _
Public Property BackgroundImageLayout As ImageLayout

Dim instance As SimpleShape
Dim value As ImageLayout

value = instance.BackgroundImageLayout

instance.BackgroundImageLayout = value

[BrowsableAttribute(true)]
public ImageLayout BackgroundImageLayout { get; set; }

[BrowsableAttribute(true)]
public:
property ImageLayout BackgroundImageLayout {
    ImageLayout get ();
    void set (ImageLayout value);
}

public function get BackgroundImageLayout () : ImageLayout
public function set BackgroundImageLayout (value : ImageLayout)

Valor de propiedad

Tipo: System.Windows.Forms.ImageLayout

Uno de los valores de ImageLayout (Center, None, Stretch, Tile o Zoom). Tile es el valor predeterminado.

Comentarios

Utilice la propiedad BackgroundImageLayout para especificar la posición y el comportamiento de una imagen agregada a un control. BackgroundImageLayout sólo surte efecto si se ha establecido la propiedad BackgroundImage.

Puede aumentar el rendimiento para las imágenes grandes si establece BackgroundImageLayout en algo distinto de Tile.

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.