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

Definition

Verschiebt ein Rechteck durch den angegebenen Betrag.Moves a rectangle by the specified amount.

Überlädt

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

Verschiebt das Rechteck um den angegebenen Vektor.Moves the rectangle by the specified vector.

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

Verschiebt das Rechteck horizontal und vertikal um den jeweils angegebenen Betrag.Moves the rectangle by the specified horizontal and vertical amounts.

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

Gibt ein Rechteck zurück, das im Bezug auf das angegebene Rechteck um den angegebenen Vektor versetzt ist.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)

Gibt ein Rechteck zurück, das im Bezug auf das angegebene Rechteck um den angegebenen horizontalen und vertikalen Betrag versetzt ist.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)

Verschiebt das Rechteck um den angegebenen Vektor.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)

Parameter

offsetVector
Vector Vector Vector Vector

Ein Vektor, der die Beträge angibt, um die das Rechteck horizontal und vertikal verschoben werden soll.A vector that specifies the horizontal and vertical amounts to move the rectangle.

Ausnahmen

Diese Methode wird für das Empty-Rechteck aufgerufen.This method is called on the Empty rectangle.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Offset(Vector) -Methode verwendet wird, um die Position eines Rechtecks zu ändern.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;

}

Hinweise

Das Aufrufen dieser Methode für ein leeres RechteckRect.Empty() ist nicht zulässig.Calling this method on an empty rectangle (Rect.Empty) is not allowed.

Beachten Sie, dass Offset der Aufruf der-Methode nur dann wirksam wird, wenn X Sie Y die-Eigenschaft und die-Eigenschaft direkt ändern können.Note that calling the Offset method will only have an effect if you can change the X and Y properties directly. Da Rect ein Werttyp ist und Sie auf ein Rect -Objekt mithilfe einer Eigenschaft oder eines Indexers verweisen, erhalten Sie eine Kopie des Objekts und keinen Verweis auf das Objekt.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. Wenn Sie versuchen, eine X Eigenschaft Y oder einen Indexer-Verweis zu ändern, tritt ein Compilerfehler auf.If you attempt to change X or Y on a property or indexer reference, a compiler error occurs. Ebenso wird beim Offset Aufrufen von für die Eigenschaft oder den Indexer das zugrunde liegende Objekt nicht geändert.Similarly, calling Offset on the property or indexer will not change the underlying object. Wenn Sie den Wert eines Rect -Objekts ändern möchten, auf das als Eigenschaft oder Indexer verwiesen wird, erstellen Sie ein neues Rect, ändern Sie seine Felder, und Rect weisen Sie dann der Eigenschaft oder dem Indexer zurück zu.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)

Verschiebt das Rechteck horizontal und vertikal um den jeweils angegebenen Betrag.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)

Parameter

offsetX
Double Double Double Double

Der Betrag, um den das Rechteck horizontal verschoben werden soll.The amount to move the rectangle horizontally.

offsetY
Double Double Double Double

Der Betrag, um den das Rechteck vertikal verschoben werden soll.The amount to move the rectangle vertically.

Ausnahmen

Diese Methode wird für das Empty-Rechteck aufgerufen.This method is called on the Empty rectangle.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Offset(Double, Double) -Methode verwendet wird, um die Position eines Rechtecks zu ändern.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;

}

Hinweise

Das Aufrufen dieser Methode für ein leeres RechteckRect.Empty() ist nicht zulässig.Calling this method on an empty rectangle (Rect.Empty) is not allowed.

Beachten Sie, dass Offset der Aufruf der-Methode nur dann wirksam wird, wenn X Sie Y die-Eigenschaft und die-Eigenschaft direkt ändern können.Note that calling the Offset method will only have an effect if you can change the X and Y properties directly. Da Rect ein Werttyp ist und Sie auf ein Rect -Objekt mithilfe einer Eigenschaft oder eines Indexers verweisen, erhalten Sie eine Kopie des Objekts und keinen Verweis auf das Objekt.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. Wenn Sie versuchen, eine X Eigenschaft Y oder einen Indexer-Verweis zu ändern, tritt ein Compilerfehler auf.If you attempt to change X or Y on a property or indexer reference, a compiler error occurs. Ebenso wird beim Offset Aufrufen von für die Eigenschaft oder den Indexer das zugrunde liegende Objekt nicht geändert.Similarly, calling Offset on the property or indexer will not change the underlying object. Wenn Sie den Wert eines Rect -Objekts ändern möchten, auf das als Eigenschaft oder Indexer verwiesen wird, erstellen Sie ein neues Rect, ändern Sie seine Felder, und Rect weisen Sie dann der Eigenschaft oder dem Indexer zurück zu.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)

Gibt ein Rechteck zurück, das im Bezug auf das angegebene Rechteck um den angegebenen Vektor versetzt ist.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

Parameter

rect
Rect Rect Rect Rect

Das ursprüngliche Rechteck.The original rectangle.

offsetVector
Vector Vector Vector Vector

Ein Vektor, der den horizontalen und den vertikalen Offset für das neue Rechteck angibt.A vector that specifies the horizontal and vertical offsets for the new rectangle.

Gibt zurück

Das sich ergebende Rechteck.The resulting rectangle.

Ausnahmen

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Offset(Rect, Vector) -Methode verwendet wird, um die Position eines Rechtecks zu ändern.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;

}

Hinweise

Das Aufrufen dieser Methode mit einem leeren RechteckRect.Empty() ist nicht zulässig.Calling this method with an empty rectangle (Rect.Empty) is not allowed.

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

Gibt ein Rechteck zurück, das im Bezug auf das angegebene Rechteck um den angegebenen horizontalen und vertikalen Betrag versetzt ist.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

Parameter

rect
Rect Rect Rect Rect

Das zu verschiebende Rechteck.The rectangle to move.

offsetX
Double Double Double Double

Der horizontale Offset für das neue Rechteck.The horizontal offset for the new rectangle.

offsetY
Double Double Double Double

Der vertikale Offset für das neue Rechteck.The vertical offset for the new rectangle.

Gibt zurück

Das sich ergebende Rechteck.The resulting rectangle.

Ausnahmen

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Offset(Rect, Double, Double) -Methode verwendet wird, um die Position eines Rechtecks zu ändern.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;

}

Hinweise

Das Aufrufen dieser Methode mit einem leeren RechteckRect.Empty() ist nicht zulässig.Calling this method with an empty rectangle (Rect.Empty) is not allowed.

Gilt für: