Rect.Offset Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

WindowsBase.dll

Přesune obdélník o zadanou hodnotu.

Přetížení

Offset(Vector)	Přesune obdélník podle zadaného vektoru.
Offset(Double, Double)	Přesune obdélník o zadané vodorovné a svislé hodnoty.
Offset(Rect, Vector)	Vrátí obdélník, který je posunut od zadaného obdélníku pomocí zadaného vektoru.
Offset(Rect, Double, Double)	Vrátí obdélník, který je posunut od zadaného obdélníku pomocí zadaných vodorovných a svislých částek.

Offset(Vector)

Přesune obdélník podle zadaného vektoru.

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

Vektor, který určuje vodorovné a svislé částky pro přesunutí obdélníku.

Výjimky

InvalidOperationException

Tato metoda je volána na obdélníku Empty .

Příklady

Následující příklad ukazuje, jak pomocí Offset(Vector) metody změnit pozici obdélníku.

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

Poznámky

Volání této metody na prázdném obdélníku (Rect.Empty) není povoleno.

Všimněte si, že volání Offset metody bude mít účinek pouze v případě, že můžete změnit X vlastnosti a Y přímo. Protože Rect je typ hodnoty, pokud odkazujete na Rect objekt pomocí vlastnosti nebo indexeru, získáte kopii objektu, nikoli odkaz na objekt. Pokud se pokusíte změnit X vlastnost nebo Y odkaz na indexer, dojde k chybě kompilátoru. Podobně volání Offset vlastnosti nebo indexeru nezmění podkladový objekt. Pokud chcete změnit hodnotu objektu Rect , na který se odkazuje jako na vlastnost nebo indexer, vytvořte nový Rectobjekt , upravte jeho pole a pak přiřaďte Rect hodnotu zpět vlastnosti nebo indexeru.

Offset(Double, Double)

Přesune obdélník o zadané vodorovné a svislé hodnoty.

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

Velikost, o kterou chcete obdélník vodorovně přesunout.

offsetY

Double

Velikost, o kterou chcete obdélník přesunout svisle.

Výjimky

InvalidOperationException

Tato metoda je volána na obdélníku Empty .

Příklady

Následující příklad ukazuje, jak pomocí Offset(Double, Double) metody změnit pozici obdélníku.

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

Poznámky

Volání této metody na prázdném obdélníku (Rect.Empty) není povoleno.

Všimněte si, že volání Offset metody bude mít účinek pouze v případě, že můžete změnit X vlastnosti a Y přímo. Protože Rect je typ hodnoty, pokud odkazujete na Rect objekt pomocí vlastnosti nebo indexeru, získáte kopii objektu, nikoli odkaz na objekt. Pokud se pokusíte změnit X vlastnost nebo Y odkaz na indexer, dojde k chybě kompilátoru. Podobně volání Offset vlastnosti nebo indexeru nezmění podkladový objekt. Pokud chcete změnit hodnotu objektu Rect , na který se odkazuje jako na vlastnost nebo indexer, vytvořte nový Rectobjekt , upravte jeho pole a pak přiřaďte Rect hodnotu zpět vlastnosti nebo indexeru.

Offset(Rect, Vector)

Vrátí obdélník, který je posunut od zadaného obdélníku pomocí zadaného vektoru.

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

Původní obdélník.

offsetVector

Vector

Vektor, který určuje vodorovný a svislý posun nového obdélníku.

Návraty

Rect

Výsledný obdélník

Výjimky

InvalidOperationException

rect je Empty.

Příklady

Následující příklad ukazuje, jak pomocí Offset(Rect, Vector) metody změnit pozici obdélníku.

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

Poznámky

Volání této metody s prázdným obdélníkem (Rect.Empty) není povoleno.

Offset(Rect, Double, Double)

Vrátí obdélník, který je posunut od zadaného obdélníku pomocí zadaných vodorovných a svislých částek.

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

Obdélník, který chcete přesunout.

offsetX

Double

Vodorovný posun nového obdélníku.

offsetY

Double

Svislý posun nového obdélníku.

Návraty

Rect

Výsledný obdélník

Výjimky

InvalidOperationException

rect je Empty.

Příklady

Následující příklad ukazuje, jak pomocí Offset(Rect, Double, Double) metody změnit pozici obdélníku.

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

Poznámky

Volání této metody s prázdným obdélníkem (Rect.Empty) není povoleno.