Rect.Offset Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

WindowsBase.dll

Przenosi prostokąt o określoną kwotę.

Przeciążenia

Offset(Vector)	Przenosi prostokąt według określonego wektora.
Offset(Double, Double)	Przenosi prostokąt według określonych poziomych i pionowych kwot.
Offset(Rect, Vector)	Zwraca prostokąt, który jest przesunięty z określonego prostokąta przy użyciu określonego wektora.
Offset(Rect, Double, Double)	Zwraca prostokąt, który jest przesunięty z określonego prostokąta przy użyciu określonych kwot poziomych i pionowych.

Offset(Vector)

Przenosi prostokąt według określonego wektora.

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)

Parametry

offsetVector

Vector

Wektor, który określa poziome i pionowe kwoty, aby przenieść prostokąt.

Wyjątki

InvalidOperationException

Ta metoda jest wywoływana na prostokątie Empty .

Przykłady

W poniższym przykładzie pokazano, jak za pomocą Offset(Vector) metody zmienić położenie prostokąta.

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;
}

Uwagi

Wywoływanie tej metody na pustym prostokątze (Rect.Empty) jest niedozwolone.

Należy pamiętać, że wywołanie Offset metody będzie miało wpływ tylko wtedy, gdy można bezpośrednio zmienić X właściwości i Y . Ponieważ Rect jest typem wartości, jeśli odwołujesz się do Rect obiektu przy użyciu właściwości lub indeksatora, otrzymasz kopię obiektu, a nie odwołanie do obiektu. W przypadku próby zmiany X lub Y odwołania do właściwości lub indeksatora wystąpi błąd kompilatora. Podobnie wywołanie Offset właściwości lub indeksatora nie spowoduje zmiany obiektu bazowego. Jeśli chcesz zmienić wartość obiektu Rect , do którego odwołuje się właściwość lub indeksator, utwórz nowy Rectelement , zmodyfikuj jego pola, a następnie przypisz go Rect z powrotem do właściwości lub indeksatora.

Offset(Double, Double)

Przenosi prostokąt według określonych poziomych i pionowych kwot.

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)

Parametry

offsetX

Double

Ilość, aby przenieść prostokąt w poziomie.

offsetY

Double

Kwota, aby przenieść prostokąt w pionie.

Wyjątki

InvalidOperationException

Ta metoda jest wywoływana na prostokątie Empty .

Przykłady

W poniższym przykładzie pokazano, jak za pomocą Offset(Double, Double) metody zmienić położenie prostokąta.

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;
}

Uwagi

Wywoływanie tej metody na pustym prostokątze (Rect.Empty) jest niedozwolone.

Należy pamiętać, że wywołanie Offset metody będzie miało wpływ tylko wtedy, gdy można bezpośrednio zmienić X właściwości i Y . Ponieważ Rect jest typem wartości, jeśli odwołujesz się do Rect obiektu przy użyciu właściwości lub indeksatora, otrzymasz kopię obiektu, a nie odwołanie do obiektu. W przypadku próby zmiany X lub Y odwołania do właściwości lub indeksatora wystąpi błąd kompilatora. Podobnie wywołanie Offset właściwości lub indeksatora nie spowoduje zmiany obiektu bazowego. Jeśli chcesz zmienić wartość obiektu Rect , do którego odwołuje się właściwość lub indeksator, utwórz nowy Rectelement , zmodyfikuj jego pola, a następnie przypisz go Rect z powrotem do właściwości lub indeksatora.

Offset(Rect, Vector)

Zwraca prostokąt, który jest przesunięty z określonego prostokąta przy użyciu określonego wektora.

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

Parametry

rect

Rect

Oryginalny prostokąt.

offsetVector

Vector

Wektor określający przesunięcia poziome i pionowe dla nowego prostokąta.

Zwraca

Rect

Wynikowy prostokąt.

Wyjątki

InvalidOperationException

rect to Empty.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą Offset(Rect, Vector) metody zmienić położenie prostokąta.

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;
}

Uwagi

Wywoływanie tej metody z pustym prostokątem (Rect.Empty) jest niedozwolone.

Offset(Rect, Double, Double)

Zwraca prostokąt, który jest przesunięty z określonego prostokąta przy użyciu określonych kwot poziomych i pionowych.

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

Parametry

rect

Rect

Prostokąt do przeniesienia.

offsetX

Double

Przesunięcie poziome dla nowego prostokąta.

offsetY

Double

Przesunięcie pionowe dla nowego prostokąta.

Zwraca

Rect

Wynikowy prostokąt.

Wyjątki

InvalidOperationException

rect to Empty.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą Offset(Rect, Double, Double) metody zmienić położenie prostokąta.

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;
}

Uwagi

Wywoływanie tej metody z pustym prostokątem (Rect.Empty) jest niedozwolone.