SimpleShape.BackgroundImage 屬性

發行項
08/21/2008

更新：2007 年 11 月

取得或設定形狀中所顯示的影像。

命名空間： Microsoft.VisualBasic.PowerPacks
組件： Microsoft.VisualBasic.PowerPacks.Vs (在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)

語法

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

屬性值

型別：System.Drawing.Image

Image，表示要在形狀背景中顯示的影像。

備註

BackgroundImage 屬性可以用來將圖形影像放置到形狀上。

注意事項：
設定 BackgroundImage 屬性會覆寫 BackColor、BackStyle、FillColor、FillGradientColor、FillGradientStyle 和 FillStyle 屬性的任何設定。

繼承者注意事項

在衍生類別中覆寫 BackgroundImage 屬性時，請使用基底類別的 BackgroundImage 屬性以擴充基底實作。否則，您必須提供所有的實作。您不必將 BackgroundImage 屬性的 get 和 set 兩個存取子都覆寫，如果需要時，只需覆寫其中一個即可。

範例

在下列範例中，會示範 BackgroundImage 和 BackgroundImageLayout 屬性的用法，在形狀上顯示影像。這個範例要求您的表單上必須有一個名為 OvalShape1 的 OvalShape 控制項，而且您的專案中必須有一個名為 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;
}