Rect.Offset Méthode

Définition

Espace de noms:
System.Windows
Assembly:
WindowsBase.dll

Déplace un rectangle par la quantité spécifiée.

Surcharges

Nom Description
Offset(Vector)

Déplace le rectangle par le vecteur spécifié.
Offset(Double, Double)

Déplace le rectangle par les quantités horizontales et verticales spécifiées.
Offset(Rect, Vector)

Retourne un rectangle qui est décalé du rectangle spécifié à l’aide du vecteur spécifié.
Offset(Rect, Double, Double)

Retourne un rectangle qui est décalé du rectangle spécifié à l’aide des quantités horizontales et verticales spécifiées.

Offset(Vector)

Déplace le rectangle par le vecteur spécifié.

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)

Paramètres

offsetVector
Vector

Vecteur qui spécifie les quantités horizontales et verticales pour déplacer le rectangle.

Exceptions

InvalidOperationException

Cette méthode est appelée sur le Empty rectangle.

Exemples

L’exemple suivant montre comment utiliser la Offset(Vector) méthode pour modifier la position d’un 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;
}

Remarques

L’appel de cette méthode sur un rectangle vide (Rect.Empty) n’est pas autorisé.

Notez que l’appel de la Offset méthode n’aura qu’un effet si vous pouvez modifier les propriétés et X les Y modifier directement. Comme Rect il s’agit d’un type valeur, si vous référencez un Rect objet à l’aide d’une propriété ou d’un indexeur, vous obtenez une copie de l’objet, et non une référence à l’objet. Si vous tentez de modifier X ou Y sur une référence de propriété ou d’indexeur, une erreur du compilateur se produit. De même, l’appel Offset à la propriété ou à l’indexeur ne modifie pas l’objet sous-jacent. Si vous souhaitez modifier la valeur d’un Rect objet référencé en tant que propriété ou indexeur, créez un nouveau Rect, modifiez ses champs, puis attribuez-lui la Rect valeur de retour à la propriété ou à l’indexeur.

S’applique à

Offset(Double, Double)

Déplace le rectangle par les quantités horizontales et verticales spécifiées.

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)

Paramètres

offsetX
Double

Quantité à déplacer horizontalement le rectangle.

offsetY
Double

Montant à déplacer verticalement le rectangle.

Exceptions

InvalidOperationException

Cette méthode est appelée sur le Empty rectangle.

Exemples

L’exemple suivant montre comment utiliser la Offset(Double, Double) méthode pour modifier la position d’un 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;
}

Remarques

L’appel de cette méthode sur un rectangle vide (Rect.Empty) n’est pas autorisé.

Notez que l’appel de la Offset méthode n’aura qu’un effet si vous pouvez modifier les propriétés et X les Y modifier directement. Comme Rect il s’agit d’un type valeur, si vous référencez un Rect objet à l’aide d’une propriété ou d’un indexeur, vous obtenez une copie de l’objet, et non une référence à l’objet. Si vous tentez de modifier X ou Y sur une référence de propriété ou d’indexeur, une erreur du compilateur se produit. De même, l’appel Offset à la propriété ou à l’indexeur ne modifie pas l’objet sous-jacent. Si vous souhaitez modifier la valeur d’un Rect objet référencé en tant que propriété ou indexeur, créez un nouveau Rect, modifiez ses champs, puis attribuez-lui la Rect valeur de retour à la propriété ou à l’indexeur.

S’applique à

Offset(Rect, Vector)

Retourne un rectangle qui est décalé du rectangle spécifié à l’aide du vecteur spécifié.

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

Paramètres

rect
Rect

Rectangle d’origine.

offsetVector
Vector

Vecteur qui spécifie les décalages horizontaux et verticaux pour le nouveau rectangle.

Retours

Rect

Rectangle résultant.

Exceptions

InvalidOperationException

rect a la valeur Empty.

Exemples

L’exemple suivant montre comment utiliser la Offset(Rect, Vector) méthode pour modifier la position d’un 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;
}

Remarques

L’appel de cette méthode avec un rectangle vide (Rect.Empty) n’est pas autorisé.

S’applique à

Offset(Rect, Double, Double)

Retourne un rectangle qui est décalé du rectangle spécifié à l’aide des quantités horizontales et verticales spécifiées.

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

Paramètres

rect
Rect

Rectangle à déplacer.

offsetX
Double

Décalage horizontal du nouveau rectangle.

offsetY
Double

Décalage vertical du nouveau rectangle.

Retours

Rect

Rectangle résultant.

Exceptions

InvalidOperationException

rect a la valeur Empty.

Exemples

L’exemple suivant montre comment utiliser la Offset(Rect, Double, Double) méthode pour modifier la position d’un 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;
}

Remarques

L’appel de cette méthode avec un rectangle vide (Rect.Empty) n’est pas autorisé.

S’applique à