Rect.Offset 方法

public:
 void Offset(System::Windows::Vector offsetVector);

public void Offset (System.Windows.Vector offsetVector);

member this.Offset : System.Windows.Vector -> unit

Public Sub Offset (offsetVector As Vector)

參數

例外狀況

範例

下列範例示範如何使用 Offset(Vector) 方法來變更矩形的位置。

private Point offsetExample1()
{
    // Initialize new rectangle.
    Rect myRectangle = new Rect();

    // The Location property specifies the coordinates of the upper left-hand 
    // corner of the rectangle. 
    myRectangle.Location = new Point(10, 5);

    // Set the Size property of the rectangle with a width of 200
    // and a height of 50.
    myRectangle.Size = new Size(200, 50);

    // Create a vector to use to offset the position of the rectangle.
    Vector vector1 = new Vector(20, 30);

    // The Offset method translates this rectangle by the specified vector.
    // myRectangle location changed from 10,5 to 30,35.
    myRectangle.Offset(vector1);

    // This rectangle's location changed from 10,5 to 30,35.
    return myRectangle.Location;
}

備註

不允許在空白矩形上呼叫這個方法， Rect.Empty () 。

請注意，如果您可以直接變更 和 Y 屬性， X 則呼叫 Offset 方法只會有作用。 因為 Rect 是實值型別，如果您使用屬性或索引子參考 Rect 物件，您就會取得物件的複本，而不是物件的參考。 如果您嘗試變更 X 或 Y 屬性或索引子參考，就會發生編譯器錯誤。 同樣地，在屬性或索引子上呼叫 Offset 並不會變更基礎物件。 如果您想要變更當做屬性或索引子參考的 Rect 值，請建立新的 Rect 、修改其欄位，然後將 指派 Rect 回屬性或索引子。

public:
 void Offset(double offsetX, double offsetY);

public void Offset (double offsetX, double offsetY);

member this.Offset : double * double -> unit

Public Sub Offset (offsetX As Double, offsetY As Double)

參數

例外狀況

範例

下列範例示範如何使用 Offset(Double, Double) 方法來變更矩形的位置。

private Point offsetExample2()
{
    // Initialize new rectangle.
    Rect myRectangle = new Rect();

    // The Location property specifies the coordinates of the upper left-hand 
    // corner of the rectangle. 
    myRectangle.Location = new Point(10, 5);

    // Set the Size property of the rectangle with a width of 200
    // and a height of 50.
    myRectangle.Size = new Size(200, 50);

    // The Offset method translates this rectangle by the specified horizontal and 
    // vertical amounts. 
    // myRectangle location changed from 10,5 to 30,35.
    myRectangle.Offset(20,30);

    // This rectangle's location changed from 10,5 to 30,35.
    return myRectangle.Location;
}

備註

不允許在空白矩形上呼叫這個方法， Rect.Empty () 。

請注意，如果您可以直接變更 和 Y 屬性， X 則呼叫 Offset 方法只會有作用。 因為 Rect 是實值型別，如果您使用屬性或索引子參考 Rect 物件，您就會取得物件的複本，而不是物件的參考。 如果您嘗試變更 X 或 Y 屬性或索引子參考，就會發生編譯器錯誤。 同樣地，在屬性或索引子上呼叫 Offset 並不會變更基礎物件。 如果您想要變更當做屬性或索引子參考的 Rect 值，請建立新的 Rect 、修改其欄位，然後將 指派 Rect 回屬性或索引子。

public:
 static System::Windows::Rect Offset(System::Windows::Rect rect, System::Windows::Vector offsetVector);

public static System.Windows.Rect Offset (System.Windows.Rect rect, System.Windows.Vector offsetVector);

static member Offset : System.Windows.Rect * System.Windows.Vector -> System.Windows.Rect

Public Shared Function Offset (rect As Rect, offsetVector As Vector) As Rect

參數

傳回

產生的矩形。

例外狀況

範例

下列範例示範如何使用 Offset(Rect, Vector) 方法來變更矩形的位置。

private Point offsetExample3()
{
    // Initialize new rectangle.
    Rect myRectangle = new Rect();

    // The Location property specifies the coordinates of the upper left-hand 
    // corner of the rectangle. 
    myRectangle.Location = new Point(10, 5);

    // Set the Size property of the rectangle with a width of 200
    // and a height of 50.
    myRectangle.Size = new Size(200, 50);

    // Create a vector to use to offset the position of the rectangle.
    Vector vector1 = new Vector(20, 30);

    // The Offset method translates the specified rectangle by the specified amount 
    // and returns the resulting Rect. 
    // resultRect location changed from 10,5 to 30,35.
    Rect resultRect = Rect.Offset(myRectangle, vector1);

    // This rectangle's location changed from 10,5 to 30,35.
    return resultRect.Location;
}

備註

不允許使用空矩形呼叫這個方法， Rect.Empty () 。

public:
 static System::Windows::Rect Offset(System::Windows::Rect rect, double offsetX, double offsetY);

public static System.Windows.Rect Offset (System.Windows.Rect rect, double offsetX, double offsetY);

static member Offset : System.Windows.Rect * double * double -> System.Windows.Rect

Public Shared Function Offset (rect As Rect, offsetX As Double, offsetY As Double) As Rect

參數

傳回

產生的矩形。

例外狀況

範例

下列範例示範如何使用 Offset(Rect, Double, Double) 方法來變更矩形的位置。

private Point offsetExample4()
{
    // Initialize new rectangle.
    Rect myRectangle = new Rect();

    // The Location property specifies the coordinates of the upper left-hand 
    // corner of the rectangle. 
    myRectangle.Location = new Point(10, 5);

    // Set the Size property of the rectangle with a width of 200
    // and a height of 50.
    myRectangle.Size = new Size(200, 50);

    // Create a vector to use to offset the position of the rectangle.
    Vector vector1 = new Vector(20, 30);

    // The Offset method translates the specified rectangle by the specified horizontal 
    // and vertical amounts and returns the resulting Rect. 
    // resultRect location changed from 10,5 to 30,35.
    Rect resultRect = Rect.Offset(myRectangle, 20, 30);

    // This rectangle's location changed from 10,5 to 30,35.
    return resultRect.Location;
}

備註

不允許使用空矩形呼叫這個方法， Rect.Empty () 。