Rect.Offset Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

WindowsBase.dll

Sposta un rettangolo del valore specificato.

Overload

Offset(Vector)	Sposta il rettangolo dal vettore specificato.
Offset(Double, Double)	Sposta il rettangolo dei valori orizzontale e verticale specificati.
Offset(Rect, Vector)	Restituisce un rettangolo offset dal rettangolo specificato utilizzando il vettore specificato.
Offset(Rect, Double, Double)	Restituisce un rettangolo offset dal rettangolo specificato utilizzando i valori orizzontali e verticali specificati.

Offset(Vector)

Sposta il rettangolo dal vettore specificato.

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)

Parametri

offsetVector

Vector

Un vettore che specifica i valori orizzontali e verticali per spostare il rettangolo.

Eccezioni

InvalidOperationException

Questo metodo viene chiamato sul rettangolo Empty.

Esempio

Nell'esempio seguente viene illustrato come usare il Offset(Vector) metodo per modificare la posizione di un rettangolo.

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

Commenti

La chiamata a questo metodo su un rettangolo vuoto (Rect.Empty) non è consentita.

Si noti che la chiamata al Offset metodo avrà effetto solo se è possibile modificare direttamente le X proprietà e Y . Poiché Rect è un tipo di valore, se si fa riferimento a un Rect oggetto usando una proprietà o un indicizzatore, si ottiene una copia dell'oggetto, non un riferimento all'oggetto. Se si tenta di modificare X o Y in un riferimento a una proprietà o a un indicizzatore, si verifica un errore del compilatore. Analogamente, la chiamata Offset alla proprietà o all'indicizzatore non cambierà l'oggetto sottostante. Se si vuole modificare il valore di un Rect oggetto a cui viene fatto riferimento come proprietà o indicizzatore, creare un nuovo Rectoggetto , modificare i campi e quindi assegnare il valore alla proprietà o all'indicizzatore Rect .

Offset(Double, Double)

Sposta il rettangolo dei valori orizzontale e verticale specificati.

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)

Parametri

offsetX

Double

Il valore di cui spostare orizzontalmente il rettangolo.

offsetY

Double

Il valore di cui spostare verticalmente il rettangolo.

Eccezioni

InvalidOperationException

Questo metodo viene chiamato sul rettangolo Empty.

Esempio

Nell'esempio seguente viene illustrato come usare il Offset(Double, Double) metodo per modificare la posizione di un rettangolo.

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

Commenti

La chiamata a questo metodo su un rettangolo vuoto (Rect.Empty) non è consentita.

Si noti che la chiamata al Offset metodo avrà effetto solo se è possibile modificare direttamente le X proprietà e Y . Poiché Rect è un tipo di valore, se si fa riferimento a un Rect oggetto usando una proprietà o un indicizzatore, si ottiene una copia dell'oggetto, non un riferimento all'oggetto. Se si tenta di modificare X o Y in un riferimento a una proprietà o a un indicizzatore, si verifica un errore del compilatore. Analogamente, la chiamata Offset alla proprietà o all'indicizzatore non cambierà l'oggetto sottostante. Se si vuole modificare il valore di un Rect oggetto a cui viene fatto riferimento come proprietà o indicizzatore, creare un nuovo Rectoggetto , modificare i campi e quindi assegnare il valore alla proprietà o all'indicizzatore Rect .

Offset(Rect, Vector)

Restituisce un rettangolo offset dal rettangolo specificato utilizzando il vettore specificato.

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

Parametri

rect

Rect

Il rettangolo originale.

offsetVector

Vector

Un vettore che specifica gli offset orizzontali e verticali per il nuovo rettangolo.

Restituisce

Rect

Rettangolo risultante.

Eccezioni

InvalidOperationException

rect è Empty.

Esempio

Nell'esempio seguente viene illustrato come usare il Offset(Rect, Vector) metodo per modificare la posizione di un rettangolo.

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

Commenti

La chiamata a questo metodo con un rettangolo vuoto (Rect.Empty) non è consentita.

Offset(Rect, Double, Double)

Restituisce un rettangolo offset dal rettangolo specificato utilizzando i valori orizzontali e verticali specificati.

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

Parametri

rect

Rect

Rettangolo da spostare.

offsetX

Double

Offset orizzontale per il nuovo rettangolo.

offsetY

Double

Offset verticale per il nuovo rettangolo.

Restituisce

Rect

Rettangolo risultante.

Eccezioni

InvalidOperationException

rect è Empty.

Esempio

Nell'esempio seguente viene illustrato come usare il Offset(Rect, Double, Double) metodo per modificare la posizione di un rettangolo.

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

Commenti

La chiamata a questo metodo con un rettangolo vuoto (Rect.Empty) non è consentita.