Share via

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) запрещен.

Обратите внимание, что вызов Offset метода будет иметь эффект только в том случае, если вы можете изменить X свойства напрямую Y . Так как Rect это тип значения, если вы ссылаетесь на Rect объект с помощью свойства или индексатора, вы получите копию объекта, а не ссылку на объект. При попытке изменить или Y в X ссылке на свойство или индексатор возникает ошибка компилятора. Аналогичным образом вызов 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) запрещен.

Обратите внимание, что вызов Offset метода будет иметь эффект только в том случае, если вы можете изменить X свойства напрямую Y . Так как Rect это тип значения, если вы ссылаетесь на Rect объект с помощью свойства или индексатора, вы получите копию объекта, а не ссылку на объект. При попытке изменить или Y в X ссылке на свойство или индексатор возникает ошибка компилятора. Аналогичным образом вызов 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) запрещен.

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