SimpleShape.BackgroundImageLayout-Eigenschaft

Artikel
10/24/2012

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

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

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

[<BrowsableAttribute(true)>]
member BackgroundImageLayout : ImageLayout with get, set

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

Eigenschaftswert

Typ: System.Windows.Forms.ImageLayout
Einer der Werte von ImageLayout (Center,None, Stretch, Tileoder Zoom).Der Standardwert ist Tile.

Hinweise

Verwenden Sie die BackgroundImageLayout-Eigenschaft, um die Position und das Verhalten eines Bildes anzugeben, das Sie für ein Steuerelement hinzugefügt haben.BackgroundImageLayout wird nur angewendet, wenn die BackgroundImage-Eigenschaft festgelegt wird.

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 gezeigt, wie die BackgroundImage und BackgroundImageLayout-Eigenschaft verwendet, um ein Bild auf einem Formular anzuzeigen.Dieses Beispiel setzt voraus, dass Sie ein OvalShape-Steuerelement verfügen, das in einem Formular OvalShape1 und dass das Projekt eine Bildressource Image1 enthält.

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

.NET Framework-Sicherheit

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.