Graphics.TranslateTransform Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

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

Ändert den Ursprung des Koordinatensystems, indem die angegebene Übersetzung in die Transformationsmatrix dieser Graphicsvoraussteht.

Überlädt

TranslateTransform(Single, Single, MatrixOrder)	Ändert den Ursprung des Koordinatensystems, indem die angegebene Übersetzung auf die Transformationsmatrix dieses Graphics in der angegebenen Reihenfolge angewendet wird.
TranslateTransform(Single, Single)	Ändert den Ursprung des Koordinatensystems, indem die angegebene Übersetzung in die Transformationsmatrix dieser Graphicsvoraussteht.

TranslateTransform(Single, Single, MatrixOrder)

Quelle:

Graphics.cs

Ändert den Ursprung des Koordinatensystems, indem die angegebene Übersetzung auf die 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 Übersetzung.

dy

Single

Die y-Koordinate der Übersetzung.

order

MatrixOrder

Mitglied der MatrixOrder-Aufzählung, die angibt, ob die Übersetzung der Transformationsmatrix vorangestellt oder angefügt wird.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Dreht die Welttransformationsmatrix von Windows Form um 30,0F Grad.

• Verschiebt den Ursprung des Grafikobjekts durch Aufrufen von TranslateTransformund fügt die Übersetzung an die Welttransformationsmatrix an.

• 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 der Multiplikation der Transformationsmatrix mit einer Matrix, deren Übersetzungsteil die dx und dy Parameter ist. Mit dieser Methode wird die Transformationsmatrix der Graphics durch die Übersetzungsmatrix entsprechend dem parameter order vorangestellt oder angefügt.

Weitere Informationen

• Koordinatensysteme und Transformationen
• Verwenden von Transformationen in verwalteten GDI+-

TranslateTransform(Single, Single)

Quelle:

Graphics.cs

Ändert den Ursprung des Koordinatensystems, indem die angegebene Übersetzung in die Transformationsmatrix dieser Graphicsvoraussteht.

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 Übersetzung.

dy

Single

Die y-Koordinate der Übersetzung.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Dreht die Welttransformationsmatrix von Windows Form um 30,0F Grad.

• Verschiebt den Ursprung des Grafikobjekts, indem TranslateTransformaufgerufen wird und die Übersetzung in die Transformationsmatrix voraussteht.

• 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 der Multiplikation der Transformationsmatrix mit einer Matrix, deren Übersetzungsteil die dx und dy Parameter ist. Diese Methode wendet die Übersetzung an, indem die Übersetzungsmatrix auf die Transformationsmatrix vorsteht.

Weitere Informationen

• Koordinatensysteme und Transformationen
• Verwenden von Transformationen in verwalteten GDI+-