SimpleShape.BackgroundImage, propriété

Article
11/15/2012

Obtient ou définit l'image affichée dans la forme.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
<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)

Valeur de propriété

Type : System.Drawing.Image
Image qui représente l'image pour s'afficher en arrière-plan de la forme.

Notes

Utilisez la propriété d'BackgroundImage pour mettre une image graphique sur une forme.

[!REMARQUE]

Définissant la propriété d'BackgroundImage substitue des paramètres pour BackColor, BackStyle, FillColor, FillGradientColor, FillGradientStyle, et des propriétés d'FillStyle.

Remarques à l'attention des héritiers

En substituant la propriété d'BackgroundImage dans une classe dérivée, utilisez la propriété d'BackgroundImage de la classe de base pour étendre l'implémentation de base.Sinon, vous devez fournir toute l'implémentation.Vous n'êtes pas requis pour substituer le commande get et des accesseurs set de la propriété d'BackgroundImage ; vous pouvez substituer un seul cas échéant.

Exemples

L'exemple suivant montre comment utiliser les propriétés d'BackgroundImage et d'BackgroundImageLayout pour afficher une image sur une forme.Cet exemple requiert que vous avez un contrôle d'OvalShape nommé OvalShape1 sur un formulaire et que votre projet contient une ressource en image nommée 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;
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.