Propriedade SimpleShape.BackgroundImage

Artigo
10/26/2012

Obtém ou define a imagem exibida na forma.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
<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 propriedade

Tipo: System.Drawing.Image
Um Image que representa a imagem para exibir no plano de fundo da forma.

Comentários

Use o BackgroundImage propriedade para colocar uma imagem gráfica para uma forma.

Observação
Setting the BackgroundImage property overrides any settings for the BackColor, BackStyle, FillColor, FillGradientColor, FillGradientStyle, and FillStyle properties.

Observações para herdeiros

Ao substituir o BackgroundImage propriedade em uma classe derivada, use o BackgroundImage a propriedade da classe base para estender a implementação base.Caso contrário, você deve fornecer todas as a implementação.Não é necessário substituir tanto o get e set acessadores da BackgroundImage propriedade; Você pode substituir apenas um caso você precise.

Exemplos

O exemplo a seguir mostra como usar o BackgroundImage e BackgroundImageLayout propriedades para exibir uma imagem em uma forma.Este exemplo requer que você tenha um OvalShape controle denominado OvalShape1 em um formulário e que o seu projeto contém um recurso de imagem 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;
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.