Rect.Offset Metoda

Definicja

Przenosi prostokąt o określoną liczbę.Moves a rectangle by the specified amount.

Przeciążenia

Offset(Vector)

Przenosi prostokąt według określonego wektora.Moves the rectangle by the specified vector.

Offset(Double, Double)

Przenosi prostokąt o określoną ilość poziomą i pionową.Moves the rectangle by the specified horizontal and vertical amounts.

Offset(Rect, Vector)

Zwraca prostokąt, który jest przesunięty od określonego prostokąta przy użyciu określonego wektora.Returns a rectangle that is offset from the specified rectangle by using the specified vector.

Offset(Rect, Double, Double)

Zwraca prostokąt przesunięty od określonego prostokąta przy użyciu określonych wartości w poziomie i w pionie.Returns a rectangle that is offset from the specified rectangle by using the specified horizontal and vertical amounts.

Offset(Vector)

Przenosi prostokąt według określonego wektora.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)

Parametry

offsetVector
Vector

Wektor, który określa wielkość w poziomie i pionie, aby przenieść prostokąt.A vector that specifies the horizontal and vertical amounts to move the rectangle.

Wyjątki

Ta metoda jest wywoływana w prostokącie Empty.This method is called on the Empty rectangle.

Przykłady

Poniższy przykład pokazuje, jak za pomocą metody Offset(Vector) zmienić położenie prostokąta.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;

}

Uwagi

Wywołanie tej metody w pustym prostokącie (Rect.Empty) jest niedozwolone.Calling this method on an empty rectangle (Rect.Empty) is not allowed.

Należy zauważyć, że wywołanie metody Offset będzie miało wpływ tylko wtedy, gdy można zmienić właściwości X i Y bezpośrednio.Note that calling the Offset method will only have an effect if you can change the X and Y properties directly. Ponieważ Rect jest typem wartości, jeśli odwołujesz się do obiektu Rect przy użyciu właściwości lub indeksatora, uzyskasz kopię obiektu, a nie odwołanie do obiektu.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. W przypadku próby zmiany X lub Y w odwołaniu do właściwości lub indeksatora wystąpi błąd kompilatora.If you attempt to change X or Y on a property or indexer reference, a compiler error occurs. Podobnie wywoływanie Offset na właściwości lub indeksatorze nie spowoduje zmiany bazowego obiektu.Similarly, calling Offset on the property or indexer will not change the underlying object. Jeśli chcesz zmienić wartość Rect, do którego odwołuje się właściwość lub indeksator, Utwórz nową Rect, zmodyfikuj jej pola, a następnie przypisz Rect z powrotem do właściwości lub indeksatora.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)

Przenosi prostokąt o określoną ilość poziomą i pionową.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)

Parametry

offsetX
Double

Kwota do przeniesienia prostokąta w poziomie.The amount to move the rectangle horizontally.

offsetY
Double

Kwota do przeniesienia prostokąta w pionie.The amount to move the rectangle vertically.

Wyjątki

Ta metoda jest wywoływana w prostokącie Empty.This method is called on the Empty rectangle.

Przykłady

Poniższy przykład pokazuje, jak za pomocą metody Offset(Double, Double) zmienić położenie prostokąta.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;

}

Uwagi

Wywołanie tej metody w pustym prostokącie (Rect.Empty) jest niedozwolone.Calling this method on an empty rectangle (Rect.Empty) is not allowed.

Należy zauważyć, że wywołanie metody Offset będzie miało wpływ tylko wtedy, gdy można zmienić właściwości X i Y bezpośrednio.Note that calling the Offset method will only have an effect if you can change the X and Y properties directly. Ponieważ Rect jest typem wartości, jeśli odwołujesz się do obiektu Rect przy użyciu właściwości lub indeksatora, uzyskasz kopię obiektu, a nie odwołanie do obiektu.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. W przypadku próby zmiany X lub Y w odwołaniu do właściwości lub indeksatora wystąpi błąd kompilatora.If you attempt to change X or Y on a property or indexer reference, a compiler error occurs. Podobnie wywoływanie Offset na właściwości lub indeksatorze nie spowoduje zmiany bazowego obiektu.Similarly, calling Offset on the property or indexer will not change the underlying object. Jeśli chcesz zmienić wartość Rect, do którego odwołuje się właściwość lub indeksator, Utwórz nową Rect, zmodyfikuj jej pola, a następnie przypisz Rect z powrotem do właściwości lub indeksatora.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)

Zwraca prostokąt, który jest przesunięty od określonego prostokąta przy użyciu określonego wektora.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

Parametry

rect
Rect

Oryginalny prostokąt.The original rectangle.

offsetVector
Vector

Wektor, który określa przesunięcie w poziomie i w pionie dla nowego prostokąta.A vector that specifies the horizontal and vertical offsets for the new rectangle.

Zwraca

Prostokątny.The resulting rectangle.

Wyjątki

Przykłady

Poniższy przykład pokazuje, jak za pomocą metody Offset(Rect, Vector) zmienić położenie prostokąta.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;

}

Uwagi

Wywołanie tej metody z pustym prostokątem (Rect.Empty) jest niedozwolone.Calling this method with an empty rectangle (Rect.Empty) is not allowed.

Offset(Rect, Double, Double)

Zwraca prostokąt przesunięty od określonego prostokąta przy użyciu określonych wartości w poziomie i w pionie.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

Parametry

rect
Rect

Prostokąt do przeniesienia.The rectangle to move.

offsetX
Double

Przesunięcie w poziomie dla nowego prostokąta.The horizontal offset for the new rectangle.

offsetY
Double

Przesunięcie w pionie dla nowego prostokąta.The vertical offset for the new rectangle.

Zwraca

Prostokątny.The resulting rectangle.

Wyjątki

Przykłady

Poniższy przykład pokazuje, jak za pomocą metody Offset(Rect, Double, Double) zmienić położenie prostokąta.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;

}

Uwagi

Wywołanie tej metody z pustym prostokątem (Rect.Empty) jest niedozwolone.Calling this method with an empty rectangle (Rect.Empty) is not allowed.

Dotyczy