Graphics.TranslateTransform Methode
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ändert den Ursprung des Koordinatensystems, indem die angegebene Übersetzung in die Transformationsmatrix dieser Graphicsvoraussteht.
| TranslateTransform(Single, Single) |
Ändert den Ursprung des Koordinatensystems, indem die angegebene Übersetzung in die Transformationsmatrix dieser Graphicsvoraussteht. |
| TranslateTransform(Single, Single, MatrixOrder) |
Ändert den Ursprung des Koordinatensystems, indem die angegebene Übersetzung auf die Transformationsmatrix dieses Graphics in der angegebenen Reihenfolge angewendet wird. |
- Quelle:
- Graphics.cs
- Quelle:
- Graphics.cs
- Quelle:
- Graphics.cs
- Quelle:
- Graphics.cs
- 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 -> unitPublic 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
Gilt für:
.NET 9 und andere Versionen
| Produkt | Versionen |
|---|---|
| .NET | 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
- Quelle:
- Graphics.cs
- Quelle:
- Graphics.cs
- Quelle:
- Graphics.cs
- Quelle:
- Graphics.cs
- 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 -> unitPublic 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
Gilt für:
.NET 9 und andere Versionen
| Produkt | Versionen |
|---|---|
| .NET | 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Feedback zu .NET
.NET ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: