SimpleShape.Location プロパティ

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

更新 : 2007 年 11 月

コンテナの左上隅に対して相対的な図形の左上隅の座標を取得または設定します。

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

構文

'宣言
<BrowsableAttribute(True)> _
Public Property Location As Point
'使用
Dim instance As SimpleShape
Dim value As Point

value = instance.Location

instance.Location = value

[BrowsableAttribute(true)]
public Point Location { get; set; }

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

public function get Location () : Point
public function set Location (value : Point)

プロパティ値

型 : System.Drawing.Point

図形の左上隅をコンテナの左上隅に対して相対的に表す Point。

解説

Point クラスは値型 (Visual Basic では Structure、Visual C# では struct) であるため、戻り値は値です。つまり、プロパティにアクセスすると、図形の左上隅のポイントのコピーが返されます。したがって、このプロパティから返された Point の x パラメータまたは y パラメータを調整しても、図形の Left、Right、Top、または Bottom の各プロパティ値に影響はありません。これらのプロパティを調整するには、各プロパティ値を個別に設定するか、または新しい Point を使用して Location プロパティを設定します。

例

Location プロパティを使用して OvalShape コントロールの移動する方法を次の例に示します。この例では、OvalShape1 という名前の OvalShape コントロールがフォームに配置されている必要があります。

Private Sub OvalShape1_Click(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) Handles OvalShape1.Click
    ' Move the shape incrementally until it reaches the bottom 
    ' of the form.
    If OvalShape1.Bottom < Me.ClientSize.Height - 50 Then
        ' Move down 50 pixels.
        OvalShape1.Location = New Point(OvalShape1.Left, _
          OvalShape1.Top + 50)
    Else
        ' Move back to the top.
        OvalShape1.Location = New Point(OvalShape1.Left, 0)
    End If
End Sub

private void ovalShape1_Click(System.Object sender, System.EventArgs e)
{
    // Move the shape incrementally until it reaches the bottom 
    // of the form.
    if (ovalShape1.Bottom < this.ClientSize.Height - 50)
    // Move down 50 pixels.
    {
        ovalShape1.Location = new Point(ovalShape1.Left, ovalShape1.Top + 50);
    }
    else
    {
        // Move back to the top.
        ovalShape1.Location = new Point(ovalShape1.Left, 0);
    }
}