SimpleShape.BackgroundImageLayout-Eigenschaft

Článek
08/23/2008

Aktualisiert: November 2007

Ruft ab oder legt fest, welches Hintergrundbildlayout gemäß der Definition in der ImageLayout-Enumeration verwendet wird.

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

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Property BackgroundImageLayout As ImageLayout
'Usage
Dim instance As SimpleShape
Dim value As ImageLayout

value = instance.BackgroundImageLayout

instance.BackgroundImageLayout = value

[BrowsableAttribute(true)]
public ImageLayout BackgroundImageLayout { get; set; }

[BrowsableAttribute(true)]
public:
property ImageLayout BackgroundImageLayout {
    ImageLayout get ();
    void set (ImageLayout value);
}

public function get BackgroundImageLayout () : ImageLayout
public function set BackgroundImageLayout (value : ImageLayout)

Eigenschaftenwert

Typ: System.Windows.Forms.ImageLayout

Einer der Werte von ImageLayout (Center, None, Stretch, Tile oder Zoom). Tile ist der Standardwert.

Hinweise

Geben Sie mithilfe der BackgroundImageLayout-Eigenschaft die Position und das Verhalten eines Bilds an, das Sie einem Steuerelement hinzugefügt haben. BackgroundImageLayout wird erst wirksam, wenn Sie einen Wert für die BackgroundImage-Eigenschaft festgelegt haben.

Sie können die Leistung für große Bilder erhöhen, wenn Sie BackgroundImageLayout auf einen anderen Wert als Tile festlegen.

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.