Rect.Offset Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

WindowsBase.dll

Dikdörtgeni belirtilen miktarda taşır.

Aşırı Yüklemeler

Offset(Vector)	Dikdörtgeni belirtilen vektöre göre taşır.
Offset(Double, Double)	Dikdörtgeni belirtilen yatay ve dikey miktarlarla taşır.
Offset(Rect, Vector)	Belirtilen vektör kullanılarak belirtilen dikdörtgenden uzaklığı olan bir dikdörtgen döndürür.
Offset(Rect, Double, Double)	Belirtilen yatay ve dikey miktarları kullanarak belirtilen dikdörtgenden uzaklığı olan bir dikdörtgen döndürür.

Offset(Vector)

Dikdörtgeni belirtilen vektöre göre taşır.

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)

Parametreler

offsetVector

Vector

Dikdörtgeni taşımak için yatay ve dikey miktarları belirten bir vektör.

Özel durumlar

InvalidOperationException

Bu yöntem dikdörtgende çağrılır Empty .

Örnekler

Aşağıdaki örnekte, dikdörtgenin Offset(Vector) konumunu değiştirmek için yönteminin nasıl kullanılacağı gösterilmektedir.

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

Açıklamalar

Bu yöntemi boş bir dikdörtgende (Rect.Empty) çağırmaya izin verilmez.

yöntemini çağırmanın Offset yalnızca ve Y özelliklerini doğrudan değiştirebilmeniz X durumunda etkili olacağını unutmayın. Rect Bir değer türü olduğundan, bir Rect nesneye bir özellik veya dizin oluşturucu kullanarak başvurursanız, nesneye başvuru değil, nesnenin bir kopyasını alırsınız. Bir özelliği veya Y dizin oluşturucu başvuruyu değiştirmeye X çalışırsanız, derleyici hatası oluşur. Benzer şekilde, özelliğinde veya dizin oluşturucuda çağrılması Offset , temel alınan nesneyi değiştirmez. Özellik veya dizin oluşturucu olarak başvuruda bulunılan değerini Rect değiştirmek istiyorsanız, yeni Rectbir oluşturun, alanlarını değiştirin ve ardından özelliğine veya dizin oluşturucuya geri atayın Rect .

Offset(Double, Double)

Dikdörtgeni belirtilen yatay ve dikey miktarlarla taşır.

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)

Parametreler

offsetX

Double

Dikdörtgeni yatay olarak taşıma miktarı.

offsetY

Double

Dikdörtgeni dikey olarak taşıma miktarı.

Özel durumlar

InvalidOperationException

Bu yöntem dikdörtgende çağrılır Empty .

Örnekler

Aşağıdaki örnekte, dikdörtgenin Offset(Double, Double) konumunu değiştirmek için yönteminin nasıl kullanılacağı gösterilmektedir.

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

Açıklamalar

Bu yöntemi boş bir dikdörtgende (Rect.Empty) çağırmaya izin verilmez.

yöntemini çağırmanın Offset yalnızca ve Y özelliklerini doğrudan değiştirebilmeniz X durumunda etkili olacağını unutmayın. Rect Bir değer türü olduğundan, bir Rect nesneye bir özellik veya dizin oluşturucu kullanarak başvurursanız, nesneye başvuru değil, nesnenin bir kopyasını alırsınız. Bir özelliği veya Y dizin oluşturucu başvuruyu değiştirmeye X çalışırsanız, derleyici hatası oluşur. Benzer şekilde, özelliğinde veya dizin oluşturucuda çağrılması Offset , temel alınan nesneyi değiştirmez. Özellik veya dizin oluşturucu olarak başvuruda bulunılan değerini Rect değiştirmek istiyorsanız, yeni Rectbir oluşturun, alanlarını değiştirin ve ardından özelliğine veya dizin oluşturucuya geri atayın Rect .

Offset(Rect, Vector)

Belirtilen vektör kullanılarak belirtilen dikdörtgenden uzaklığı olan bir dikdörtgen döndürür.

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

Parametreler

rect

Rect

Özgün dikdörtgen.

offsetVector

Vector

Yeni dikdörtgen için yatay ve dikey uzaklıkları belirten bir vektör.

Döndürülenler

Rect

Elde edilen dikdörtgen.

Özel durumlar

InvalidOperationException

rect, Empty değeridir.

Örnekler

Aşağıdaki örnekte, dikdörtgenin Offset(Rect, Vector) konumunu değiştirmek için yönteminin nasıl kullanılacağı gösterilmektedir.

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

Açıklamalar

Bu yöntemi boş bir dikdörtgenle (Rect.Empty) çağırmaya izin verilmez.

Offset(Rect, Double, Double)

Belirtilen yatay ve dikey miktarları kullanarak belirtilen dikdörtgenden uzaklığı olan bir dikdörtgen döndürür.

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

Parametreler

rect

Rect

Taşınacak dikdörtgen.

offsetX

Double

Yeni dikdörtgen için yatay uzaklık.

offsetY

Double

Yeni dikdörtgen için dikey uzaklık.

Döndürülenler

Rect

Elde edilen dikdörtgen.

Özel durumlar

InvalidOperationException

rect, Empty değeridir.

Örnekler

Aşağıdaki örnekte, dikdörtgenin Offset(Rect, Double, Double) konumunu değiştirmek için yönteminin nasıl kullanılacağı gösterilmektedir.

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

Açıklamalar

Bu yöntemi boş bir dikdörtgenle (Rect.Empty) çağırmaya izin verilmez.