Rect.Offset Rect.Offset Rect.Offset Rect.Offset Method

定義

指定した量だけ四角形を移動します。Moves a rectangle by the specified amount.

オーバーロード

Offset(Vector) Offset(Vector) Offset(Vector) Offset(Vector)

指定したベクターだけ四角形を移動します。Moves the rectangle by the specified vector.

Offset(Double, Double) Offset(Double, Double) Offset(Double, Double) Offset(Double, Double)

四角形を水平方向および垂直方向に指定した量だけ移動します。Moves the rectangle by the specified horizontal and vertical amounts.

Offset(Rect, Vector) Offset(Rect, Vector) Offset(Rect, Vector)

指定したベクターを使用して、指定した四角形からのオフセットである四角形を返します。Returns a rectangle that is offset from the specified rectangle by using the specified vector.

Offset(Rect, Double, Double) Offset(Rect, Double, Double) Offset(Rect, Double, Double)

指定した水平方向および垂直後方の量を使用して、指定した四角形からのオフセットである四角形を返します。Returns a rectangle that is offset from the specified rectangle by using the specified horizontal and vertical amounts.

Offset(Vector) Offset(Vector) Offset(Vector) Offset(Vector)

指定したベクターだけ四角形を移動します。Moves the rectangle by the specified 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 Vector Vector Vector

四角形を水平方向および垂直方向に移動する量を指定するベクター。A vector that specifies the horizontal and vertical amounts to move the rectangle.

例外

このメソッドは、Empty 四角形で呼び出されます。This method is called on the Empty rectangle.

次の例は、 Offset(Vector)メソッドを使用して四角形の位置を変更する方法を示しています。The following example shows how to use the Offset(Vector) method to change the position of a rectangle.

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) に対してこのメソッドを呼び出すことはできません。Calling this method on an empty rectangle (Rect.Empty) is not allowed.

Offsetメソッドを呼び出すXと、プロパティとYプロパティを直接変更できる場合にのみ効果が得られることに注意してください。Note that calling the Offset method will only have an effect if you can change the X and Y properties directly. Rect値型であるため、プロパティまたはRectインデクサーを使用してオブジェクトを参照する場合は、オブジェクトへの参照ではなく、オブジェクトのコピーを取得します。Because Rect is a value type, if you reference a Rect object by using a property or indexer, you get a copy of the object, not a reference to the object. プロパティまたはインデクサー参照XYまたはを変更しようとすると、コンパイラエラーが発生します。If you attempt to change X or Y on a property or indexer reference, a compiler error occurs. 同様に、 Offsetプロパティまたはインデクサーでを呼び出すと、基になるオブジェクトが変更されません。Similarly, calling Offset on the property or indexer will not change the underlying object. プロパティまたはインデクサーとして参照さRectれているの値を変更する場合は、新しいRectを作成し、そのフィールドを変更しRectてから、プロパティまたはインデクサーにを割り当て直します。If you want to change the value of a Rect that is referenced as a property or indexer, create a new Rect, modify its fields, and then assign the Rect back to the property or indexer.

Offset(Double, Double) Offset(Double, Double) Offset(Double, Double) Offset(Double, Double)

四角形を水平方向および垂直方向に指定した量だけ移動します。Moves the rectangle by the specified horizontal and vertical amounts.

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

四角形の水平方向の移動量。The amount to move the rectangle horizontally.

offsetY
Double Double Double Double

四角形の垂直方向の移動量。The amount to move the rectangle vertically.

例外

このメソッドは、Empty 四角形で呼び出されます。This method is called on the Empty rectangle.

次の例は、 Offset(Double, Double)メソッドを使用して四角形の位置を変更する方法を示しています。The following example shows how to use the Offset(Double, Double) method to change the position of a rectangle.

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) に対してこのメソッドを呼び出すことはできません。Calling this method on an empty rectangle (Rect.Empty) is not allowed.

Offsetメソッドを呼び出すXと、プロパティとYプロパティを直接変更できる場合にのみ効果が得られることに注意してください。Note that calling the Offset method will only have an effect if you can change the X and Y properties directly. Rect値型であるため、プロパティまたはRectインデクサーを使用してオブジェクトを参照する場合は、オブジェクトへの参照ではなく、オブジェクトのコピーを取得します。Because Rect is a value type, if you reference a Rect object by using a property or indexer, you get a copy of the object, not a reference to the object. プロパティまたはインデクサー参照XYまたはを変更しようとすると、コンパイラエラーが発生します。If you attempt to change X or Y on a property or indexer reference, a compiler error occurs. 同様に、 Offsetプロパティまたはインデクサーでを呼び出すと、基になるオブジェクトが変更されません。Similarly, calling Offset on the property or indexer will not change the underlying object. プロパティまたはインデクサーとして参照さRectれているの値を変更する場合は、新しいRectを作成し、そのフィールドを変更しRectてから、プロパティまたはインデクサーにを割り当て直します。If you want to change the value of a Rect that is referenced as a property or indexer, create a new Rect, modify its fields, and then assign the Rect back to the property or indexer.

Offset(Rect, Vector) Offset(Rect, Vector) Offset(Rect, Vector)

指定したベクターを使用して、指定した四角形からのオフセットである四角形を返します。Returns a rectangle that is offset from the specified rectangle by using the specified 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

パラメーター

rect
Rect Rect Rect Rect

元の四角形。The original rectangle.

offsetVector
Vector Vector Vector Vector

新しい四角形の水平方向および垂直方向のオフセットを指定するベクター。A vector that specifies the horizontal and vertical offsets for the new rectangle.

戻り値

結果として得られる四角形。The resulting rectangle.

例外

次の例は、 Offset(Rect, Vector)メソッドを使用して四角形の位置を変更する方法を示しています。The following example shows how to use the Offset(Rect, Vector) method to change the position of a rectangle.

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) を指定してこのメソッドを呼び出すことはできません。Calling this method with an empty rectangle (Rect.Empty) is not allowed.

Offset(Rect, Double, Double) Offset(Rect, Double, Double) Offset(Rect, Double, Double)

指定した水平方向および垂直後方の量を使用して、指定した四角形からのオフセットである四角形を返します。Returns a rectangle that is offset from the specified rectangle by using the specified horizontal and vertical amounts.

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

パラメーター

rect
Rect Rect Rect Rect

移動対象の四角形。The rectangle to move.

offsetX
Double Double Double Double

新しい四角形の水平方向のオフセット。The horizontal offset for the new rectangle.

offsetY
Double Double Double Double

新しい四角形の垂直方向のオフセット。The vertical offset for the new rectangle.

戻り値

結果として得られる四角形。The resulting rectangle.

例外

次の例は、 Offset(Rect, Double, Double)メソッドを使用して四角形の位置を変更する方法を示しています。The following example shows how to use the Offset(Rect, Double, Double) method to change the position of a rectangle.

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) を指定してこのメソッドを呼び出すことはできません。Calling this method with an empty rectangle (Rect.Empty) is not allowed.

適用対象