SimpleShape.BackgroundImage-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft das in der Form angezeigte Bild ab oder legt dieses fest.

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

Syntax

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

Eigenschaftenwert

Typ: System.Drawing.Image

Image, das das im Hintergrund der Form anzuzeigende Bild darstellt.

Hinweise

Fügen Sie mithilfe der BackgroundImage-Eigenschaft ein grafisches Bild auf einer Form ein.

Hinweis:
Durch Festlegen der BackgroundImage-Eigenschaft werden die Einstellungen der folgenden Eigenschaften überschrieben: BackColor, BackStyle, FillColor, FillGradientColor, FillGradientStyle und FillStyle.

Hinweise zur Vererbung:

Verwenden Sie beim Überschreiben der BackgroundImage-Eigenschaft in einer abgeleiteten Klasse die BackgroundImage-Eigenschaft der Basisklasse, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Sie müssen nicht sowohl den get-Accessor als auch den set-Accessor der BackgroundImage-Eigenschaft überschreiben. Sie können ggf. auch nur einen Accessor überschreiben.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mit den Eigenschaften BackgroundImage und BackgroundImageLayout ein Bild auf einer Form anzeigen. Für dieses Beispiel ist ein OvalShape-Steuerelement mit dem Namen OvalShape1 auf einem Formular erforderlich, und das Projekt muss eine Bildressource mit dem Namen Image1 enthalten.

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.