Rect.Offset 方法

定義

命名空間:

System.Windows

組件:

WindowsBase.dll

以指定的數量移動矩形。

多載

Offset(Vector)	以指定的向量移動矩形。
Offset(Double, Double)	以指定的水平和垂直數量移動矩形。
Offset(Rect, Vector)	傳回矩形，這個矩形是使用所指定向量從指定之矩形位移的矩形。
Offset(Rect, Double, Double)	傳回矩形，這個矩形是使用所指定水平和垂直數量從指定之矩形位移的矩形。

Offset(Vector)

以指定的向量移動矩形。

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)

參數

offsetVector

Vector

向量，指定用來移動矩形的水平和垂直數量。

例外狀況

InvalidOperationException

這個方法是在 Empty 矩形上呼叫。

範例

下列範例示範如何使用 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 回屬性或索引子。

Offset(Double, Double)

以指定的水平和垂直數量移動矩形。

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)

參數

offsetX

Double

要水平移動矩形的數量。

offsetY

Double

要垂直移動矩形的數量。

例外狀況

InvalidOperationException

這個方法是在 Empty 矩形上呼叫。

範例

下列範例示範如何使用 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 回屬性或索引子。

Offset(Rect, Vector)

傳回矩形，這個矩形是使用所指定向量從指定之矩形位移的矩形。

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

參數

rect

Rect

原始矩形。

offsetVector

Vector

指定新矩形的水平和垂直位移的向量。

傳回

Rect

產生的矩形。

例外狀況

InvalidOperationException

rect 為 Empty。

範例

下列範例示範如何使用 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 () 。

Offset(Rect, Double, Double)

傳回矩形，這個矩形是使用所指定水平和垂直數量從指定之矩形位移的矩形。

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

參數

rect

Rect

要移動的矩形。

offsetX

Double

新矩形的水平位移。

offsetY

Double

新矩形的垂直位移。

傳回

Rect

產生的矩形。

例外狀況

InvalidOperationException

rect 為 Empty。

範例

下列範例示範如何使用 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 () 。