SimpleShape.BackgroundImage, propriété

Mise à jour : novembre 2007

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

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

Valeur de propriété

Type : System.Drawing.Image

Image qui représente l'image à afficher à l'arrière-plan de la forme.

Notes

Utilisez la propriété BackgroundImage pour placer une image graphique sur une forme.

Remarque :
La définition de la propriété BackgroundImage substitue tous les paramètres des propriétés BackColor, BackStyle, FillColor, FillGradientColor, FillGradientStyle et FillStyle.

Remarques à l'attention des héritiers :

Lors de la substitution de la propriété BackgroundImage dans une classe dérivée, utilisez la propriété BackgroundImage de la classe de base pour étendre l'implémentation de base. Sinon, vous devez fournir toute l'implémentation. Il n'est pas nécessaire de substituer les deux accesseurs get et set de la propriété BackgroundImage ; vous pouvez en substituer un seul si nécessaire.

Exemples

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

Autorisations

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.