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. При попытке изменить X или Y в ссылке на свойство или индексатор возникает ошибка компилятора.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. При попытке изменить X или Y в ссылке на свойство или индексатор возникает ошибка компилятора.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.

Применяется к