Rect.Offset Methode

Referenz

Definition

Namespace:: System.Windows

Assembly:: WindowsBase.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Verschiebt ein Rechteck durch den angegebenen Betrag.

Überlädt

Offset(Vector)	Verschiebt das Rechteck um den angegebenen Vektor.
Offset(Double, Double)	Verschiebt das Rechteck horizontal und vertikal um den jeweils angegebenen Betrag.
Offset(Rect, Vector)	Gibt ein Rechteck zurück, das im Bezug auf das angegebene Rechteck um den angegebenen Vektor versetzt ist.
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.

Offset(Vector)

Verschiebt das Rechteck um den angegebenen Vektor.

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

Ein Vektor, der die Beträge angibt, um die das Rechteck horizontal und vertikal verschoben werden soll.

Ausnahmen

InvalidOperationException

Diese Methode wird für das Empty-Rechteck aufgerufen.

Beispiele

Das folgende Beispiel zeigt, wie die Offset(Vector) -Methode verwendet wird, um die Position eines Rechtecks zu ändern.

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 Rechteck (Rect.Empty) ist nicht zulässig.

Beachten Sie, dass das Aufrufen der Offset -Methode nur dann Auswirkungen hat, wenn Sie die X Eigenschaften und Y direkt ändern können. Da Rect ein Werttyp ist. Wenn Sie mithilfe einer Eigenschaft oder eines Indexers auf ein Rect Objekt verweisen, erhalten Sie eine Kopie des Objekts und keinen Verweis auf das Objekt. Wenn Sie versuchen, oder Y für einen Eigenschafts- oder Indexerverweis zu ändernX, tritt ein Compilerfehler auf. Ebenso ändert das Aufrufen Offset der Eigenschaft oder des Indexers das zugrunde liegende Objekt nicht. Wenn Sie den Wert einer Rect ändern möchten, auf die als Eigenschaft oder Indexer verwiesen wird, erstellen Sie einen neuen Rect, ändern Sie dessen Felder, und weisen Sie dann der Eigenschaft oder dem Indexer zurück Rect zu.

Gilt für:

Offset(Double, Double)

Verschiebt das Rechteck horizontal und vertikal um den jeweils angegebenen Betrag.

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

Der Betrag, um den das Rechteck horizontal verschoben werden soll.

offsetY: Double

Der Betrag, um den das Rechteck vertikal verschoben werden soll.

Ausnahmen

InvalidOperationException

Diese Methode wird für das Empty-Rechteck aufgerufen.

Beispiele

Das folgende Beispiel zeigt, wie die Offset(Double, Double) -Methode verwendet wird, um die Position eines Rechtecks zu ändern.

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 Rechteck (Rect.Empty) ist nicht zulässig.

Gilt für:

Offset(Rect, Vector)

Gibt ein Rechteck zurück, das im Bezug auf das angegebene Rechteck um den angegebenen Vektor versetzt ist.

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

Parameter

rect: Rect

Das ursprüngliche Rechteck.

offsetVector: Vector

Ein Vektor, der den horizontalen und den vertikalen Offset für das neue Rechteck angibt.

Gibt zurück

Rect

Das sich ergebende Rechteck.

Ausnahmen

InvalidOperationException

rect ist Empty.

Beispiele

Das folgende Beispiel zeigt, wie die Offset(Rect, Vector) -Methode verwendet wird, um die Position eines Rechtecks zu ändern.

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 Rechteck (Rect.Empty) ist nicht zulässig.

Gilt für:

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.

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

Parameter

rect: Rect

Das zu verschiebende Rechteck.

offsetX: Double

Der horizontale Offset für das neue Rechteck.

offsetY: Double

Der vertikale Offset für das neue Rechteck.

Gibt zurück

Rect

Das sich ergebende Rechteck.

Ausnahmen

InvalidOperationException

rect ist Empty.

Beispiele

Das folgende Beispiel zeigt, wie die Offset(Rect, Double, Double) -Methode verwendet wird, um die Position eines Rechtecks zu ändern.

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 Rechteck (Rect.Empty) ist nicht zulässig.

Gilt für:

Freigeben über

Rect.Offset Methode

Definition

Überlädt

Offset(Vector)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Offset(Double, Double)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Offset(Rect, Vector)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Offset(Rect, Double, Double)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen