Propriedade SimpleShape.BackgroundImage

Artigo
08/25/2010

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

<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 propriedade

Tipo: System.Drawing.Image
An Image que representa a imagem a ser exibida em segundo plano da forma.

Comentários

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

Observação:
configuração o BackgroundImage propriedade substitui quaisquer configurações para o BackColor, BackStyle, FillColor, FillGradientColor, FillGradientStyle, e FillStyle Propriedades.

Observações para Inheritors:

Ao substituir o BackgroundImage propriedade em uma classe derivada, uso o BackgroundImage propriedade da classe base para estender a implementação base. Caso contrário, você deve fornecer todas as implementação.Não é necessário substituir os dois get e conjunto acessadores do BackgroundImage propriedade; você pode substituir apenas um se for necessário.

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 chamado OvalShape1 em um formulário e que seu projeto contém um recurso de imagem denominado Image1.

PrivateSub Form1_Load(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) HandlesMyBase.Load
    ' Assign an image resource.
    OvalShape1.BackgroundImage = My.Resources.Image1
    ' Resize the image to fit the oval.
    OvalShape1.BackgroundImageLayout = ImageLayout.Stretch
EndSub

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

Permissões

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ódigos parcialmente Confiável.