Matrix.Translate Methode

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.6.24327.6

Wendet den angegebenen Übersetzungsvektor auf diese Matrix an, indem der Übersetzungsvektor voraussteht.

Überlädt

Translate(Single, Single)	Wendet den angegebenen Übersetzungsvektor (offsetX und offsetY) auf diese Matrix an, indem der Übersetzungsvektor voraussteht.
Translate(Single, Single, MatrixOrder)	Wendet den angegebenen Übersetzungsvektor auf diese Matrix in der angegebenen Reihenfolge an.

Translate(Single, Single)

Quelle:

Matrix.cs

Wendet den angegebenen Übersetzungsvektor (offsetX und offsetY) auf diese Matrix an, indem der Übersetzungsvektor voraussteht.

public:
 void Translate(float offsetX, float offsetY);

public void Translate (float offsetX, float offsetY);

member this.Translate : single * single -> unit

Public Sub Translate (offsetX As Single, offsetY As Single)

Parameter

offsetX

Single

Der x-Wert, um den dieser Matrixübersetzt werden soll.

offsetY

Single

Der y-Wert, um den dieser Matrixübersetzt werden soll.

Beispiele

Ein Beispiel finden Sie unter Translate(Single, Single, MatrixOrder).

Translate(Single, Single, MatrixOrder)

Quelle:

Matrix.cs

Wendet den angegebenen Übersetzungsvektor auf diese Matrix in der angegebenen Reihenfolge an.

public:
 void Translate(float offsetX, float offsetY, System::Drawing::Drawing2D::MatrixOrder order);

public void Translate (float offsetX, float offsetY, System.Drawing.Drawing2D.MatrixOrder order);

member this.Translate : single * single * System.Drawing.Drawing2D.MatrixOrder -> unit

Public Sub Translate (offsetX As Single, offsetY As Single, order As MatrixOrder)

Parameter

offsetX

Single

Der x-Wert, um den dieser Matrixübersetzt werden soll.

offsetY

Single

Der y-Wert, um den dieser Matrixübersetzt werden soll.

order

MatrixOrder

Eine MatrixOrder, die die Reihenfolge (anfügen oder vorangestellt) angibt, in der die Übersetzung auf diese Matrixangewendet wird.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, ein Paint-Ereignisobjekt. Der Code führt die folgenden Aktionen aus:

• Zeichnet ein Rechteck auf dem Bildschirm, bevor eine Übersetzungstransformation angewendet wird (das blaue Rechteck).

• Erstellt eine Matrix und übersetzt sie in beiden Achsen um 100.

• Wendet diese Matrixtransformation auf das Rechteck an,

• Zeichnet das transformierte Rechteck auf den Bildschirm (das rote Rechteck).

Beachten Sie, dass der Anfang des roten Rechtecks 100 Punkt in beiden Achsen vom Anfang des blauen Dreiecks liegt.

public:
   void TranslateExample( PaintEventArgs^ e )
   {
      Pen^ myPen = gcnew Pen( Color::Blue,1.0f );
      Pen^ myPen2 = gcnew Pen( Color::Red,1.0f );

      // Draw a rectangle to the screen before applying the
      // transform.
      e->Graphics->DrawRectangle( myPen, 20, 20, 100, 50 );

      // Create a matrix and translate it.
      Matrix^ myMatrix = gcnew Matrix;
      myMatrix->Translate( 100, 100, MatrixOrder::Append );

      // Draw the Points to the screen again after applying the
      // transform.
      e->Graphics->Transform = myMatrix;
      e->Graphics->DrawRectangle( myPen2, 20, 20, 100, 50 );
   }

public void TranslateExample(PaintEventArgs e)
{
    Pen myPen = new Pen(Color.Blue, 1);
    Pen myPen2 = new Pen(Color.Red, 1);
             
    // Draw a rectangle to the screen before applying the
    // transform.
    e.Graphics.DrawRectangle(myPen, 20, 20, 100, 50);
             
    // Create a matrix and translate it.
    Matrix myMatrix = new Matrix();
    myMatrix.Translate(100, 100, MatrixOrder.Append);
             
    // Draw the Points to the screen again after applying the
    // transform.
    e.Graphics.Transform = myMatrix;
    e.Graphics.DrawRectangle(myPen2, 20, 20, 100, 50);
}

Public Sub TranslateExample(ByVal e As PaintEventArgs)
    Dim myPen As New Pen(Color.Blue, 1)
    Dim myPen2 As New Pen(Color.Red, 1)

    ' Draw a rectangle to the screen before applying the
    ' transform.
    e.Graphics.DrawRectangle(myPen, 20, 20, 100, 50)

    ' Create a matrix and translate it.
    Dim myMatrix As New Matrix
    myMatrix.Translate(100, 100, MatrixOrder.Append)

    ' Draw the Points to the screen again after applying the
    ' transform.
    e.Graphics.Transform = myMatrix
    e.Graphics.DrawRectangle(myPen2, 20, 20, 100, 50)
End Sub