SimpleShape.BackgroundImageLayout プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

ImageLayout 列挙体で定義される背景イメージのレイアウトを取得または設定します。

名前空間 : Microsoft.VisualBasic.PowerPacks
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
<BrowsableAttribute(True)> _
Public Property BackgroundImageLayout As ImageLayout
'使用
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)

プロパティ値

型 : System.Windows.Forms.ImageLayout

ImageLayout の値 (Center、None、Stretch、Tile、または Zoom) の 1 つ。既定値は Tile です。

解説

コントロールに追加したイメージの位置および動作を指定するには、BackgroundImageLayout プロパティを使用します。BackgroundImageLayout は、BackgroundImage プロパティが設定されている場合にだけ有効になります。

BackgroundImageLayout を Tile 以外に設定することにより、大きなイメージを使用した場合のパフォーマンスを高めることができます。

例

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