Graphics.TranslateTransform Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v7.0.0

Ändert den Ursprung der Koordinaten, indem die angegebene Verschiebung der Transformationsmatrix dieses Graphics vorangestellt wird.

Überlädt

TranslateTransform(Single, Single, MatrixOrder)	Ändert den Ursprung des Koordinatensystems, indem die angegebene Verschiebung zur Transformationsmatrix dieses Graphics in der angegebenen Reihenfolge angewendet wird.
TranslateTransform(Single, Single)	Ändert den Ursprung der Koordinaten, indem die angegebene Verschiebung der Transformationsmatrix dieses Graphics vorangestellt wird.

TranslateTransform(Single, Single, MatrixOrder)

Ändert den Ursprung des Koordinatensystems, indem die angegebene Verschiebung zur Transformationsmatrix dieses Graphics in der angegebenen Reihenfolge angewendet wird.

public:
 void TranslateTransform(float dx, float dy, System::Drawing::Drawing2D::MatrixOrder order);

public void TranslateTransform (float dx, float dy, System.Drawing.Drawing2D.MatrixOrder order);

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

Public Sub TranslateTransform (dx As Single, dy As Single, order As MatrixOrder)

Parameter

dx

Single

Die x-Koordinate der Verschiebung.

dy

Single

Die y-Koordinate der Verschiebung.

order

MatrixOrder

Member der MatrixOrder-Enumeration, der angibt, ob die Verschiebung an die Transformationsmatrix angehängt oder dieser vorangestellt wird.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

• Rotiert die Welttransformationsmatrix der Windows Form um 30,0F Grad.

• Verschiebt den Ursprung des Grafikobjekts, indem aufgerufen TranslateTransformwird, indem die Übersetzung an die Welttransformationsmatrix angefügt wird.

• Zeichnet eine gedrehte, übersetzte Ellipse mit einem blauen Stift.

public:
   void TranslateTransformAngleMatrixOrder( PaintEventArgs^ e )
   {
      // Set world transform of graphics object to rotate.
      e->Graphics->RotateTransform( 30.0F );

      // Then to translate, appending to world transform.
      e->Graphics->TranslateTransform( 100.0F, 0.0F, MatrixOrder::Append );

      // Draw rotated, translated ellipse to screen.
      e->Graphics->DrawEllipse( gcnew Pen( Color::Blue,3.0f ), 0, 0, 200, 80 );
   }

private void TranslateTransformAngleMatrixOrder(PaintEventArgs e)
{

    // Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F);

    // Then to translate, appending to world transform.
    e.Graphics.TranslateTransform(100.0F, 0.0F, MatrixOrder.Append);

    // Draw rotated, translated ellipse to screen.
    e.Graphics.DrawEllipse(new Pen(Color.Blue, 3), 0, 0, 200, 80);
}

Private Sub TranslateTransformAngleMatrixOrder(ByVal e As PaintEventArgs)

    ' Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F)

    ' Then to translate, appending to world transform.
    e.Graphics.TranslateTransform(100.0F, 0.0F, MatrixOrder.Append)

    ' Draw rotated, translated ellipse to screen.
    e.Graphics.DrawEllipse(New Pen(Color.Blue, 3), 0, 0, 200, 80)
End Sub

Hinweise

Der Übersetzungsvorgang besteht aus dem Multiplizieren der Transformationsmatrix mit einer Matrix, deren Übersetzungsteil die dx Parameter und dy ist. Mit dieser Methode wird die Transformationsmatrix des Graphics durch die Übersetzungsmatrix gemäß dem order Parameter vorangestellt oder angefügt.

Weitere Informationen

• Koordinatensysteme und Transformationen
• Verwenden von Transformationen in Managed GDI+

TranslateTransform(Single, Single)

Ändert den Ursprung der Koordinaten, indem die angegebene Verschiebung der Transformationsmatrix dieses Graphics vorangestellt wird.

public:
 void TranslateTransform(float dx, float dy);

public void TranslateTransform (float dx, float dy);

member this.TranslateTransform : single * single -> unit

Public Sub TranslateTransform (dx As Single, dy As Single)

Parameter

dx

Single

Die x-Koordinate der Verschiebung.

dy

Single

Die y-Koordinate der Verschiebung.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

• Rotiert die Welttransformationsmatrix der Windows Form um 30,0F Grad.

• Verschiebt den Ursprung des Grafikobjekts, indem aufgerufen TranslateTransformwird, bevor die Übersetzung in die Transformationsmatrix erfolgt.

• Zeichnet eine übersetzte, gedrehte Ellipse mit einem blauen Stift.

public:
   void TranslateTransformAngle( PaintEventArgs^ e )
   {
      // Set world transform of graphics object to rotate.
      e->Graphics->RotateTransform( 30.0F );

      // Then to translate, prepending to world transform.
      e->Graphics->TranslateTransform( 100.0F, 0.0F );

      // Draw translated, rotated ellipse to screen.
      e->Graphics->DrawEllipse( gcnew Pen( Color::Blue,3.0f ), 0, 0, 200, 80 );
   }

private void TranslateTransformAngle(PaintEventArgs e)
{

    // Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F);

    // Then to translate, prepending to world transform.
    e.Graphics.TranslateTransform(100.0F, 0.0F);

    // Draw translated, rotated ellipse to screen.
    e.Graphics.DrawEllipse(new Pen(Color.Blue, 3), 0, 0, 200, 80);
}

Private Sub TranslateTransformAngle(ByVal e As PaintEventArgs)

    ' Set world transform of graphics object to rotate.
    e.Graphics.RotateTransform(30.0F)

    ' Then to translate, prepending to world transform.
    e.Graphics.TranslateTransform(100.0F, 0.0F)

    ' Draw translated, rotated ellipse to screen.
    e.Graphics.DrawEllipse(New Pen(Color.Blue, 3), 0, 0, 200, 80)
End Sub

Die folgende Abbildung zeigt die Ausgabe der Ausführung des vorherigen Codebeispiels.

Hinweise

Der Ursprung ist in der Regel die obere linke Ecke der Zeichnungsoberfläche. Der Übersetzungsvorgang besteht aus dem Multiplizieren der Transformationsmatrix mit einer Matrix, deren Übersetzungsteil die dx Parameter und dy ist. Bei dieser Methode wird die Übersetzung angewendet, indem die Übersetzungsmatrix auf die Transformationsmatrix festgelegt wird.

Weitere Informationen

• Koordinatensysteme und Transformationen
• Verwenden von Transformationen in Managed GDI+