GraphicsPath.Transform(Matrix) Methode

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Wendet eine Transformationsmatrix auf diese GraphicsPathan.

public:
 void Transform(System::Drawing::Drawing2D::Matrix ^ matrix);

public void Transform (System.Drawing.Drawing2D.Matrix matrix);

member this.Transform : System.Drawing.Drawing2D.Matrix -> unit

Public Sub Transform (matrix As Matrix)

Parameter

matrix

Matrix

Eine Matrix, die die anzuwendende Transformation darstellt.

Beispiele

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

• Erstellt einen Pfad und fügt dem Pfad eine Auslassungspunkte hinzu.

• Zeichnet den Pfad zum Bildschirm.

• Erstellt eine Transformationsmatrix, um den Pfad 100 Einheiten in der X-Achsenrichtung zu übersetzen.

• Zeichnet den transformierten Pfad auf dem Bildschirm.

Beachten Sie, dass die ursprüngliche Ellipse schwarz gezeichnet wird und die transformierte Ellipse rot gezeichnet wird.

private:
   void TransformExample( PaintEventArgs^ e )
   {
      // Create a path and add and ellipse.
      GraphicsPath^ myPath = gcnew GraphicsPath;
      myPath->AddEllipse( 0, 0, 100, 200 );

      // Draw the starting position to screen.
      e->Graphics->DrawPath( Pens::Black, myPath );

      // Move the ellipse 100 points to the right.
      Matrix^ translateMatrix = gcnew Matrix;
      translateMatrix->Translate( 100, 0 );
      myPath->Transform(translateMatrix);

      // Draw the transformed ellipse to the screen.
      e->Graphics->DrawPath( gcnew Pen( Color::Red,2.0f ), myPath );
   }

private void TransformExample(PaintEventArgs e)
{
             
    // Create a path and add and ellipse.
    GraphicsPath myPath = new GraphicsPath();
    myPath.AddEllipse(0, 0, 100, 200);
             
    // Draw the starting position to screen.
    e.Graphics.DrawPath(Pens.Black, myPath);
             
    // Move the ellipse 100 points to the right.
    Matrix translateMatrix = new Matrix();
    translateMatrix.Translate(100, 0);
    myPath.Transform(translateMatrix);
             
    // Draw the transformed ellipse to the screen.
    e.Graphics.DrawPath(new Pen(Color.Red, 2), myPath);
}

Public Sub TransformExample(ByVal e As PaintEventArgs)

    ' Create a path and add and ellipse.
    Dim myPath As New GraphicsPath
    myPath.AddEllipse(0, 0, 100, 200)

    ' Draw the starting position to screen.
    e.Graphics.DrawPath(Pens.Black, myPath)

    ' Move the ellipse 100 points to the right.
    Dim translateMatrix As New Matrix
    translateMatrix.Translate(100, 0)
    myPath.Transform(translateMatrix)

    ' Draw the transformed ellipse to the screen.
    e.Graphics.DrawPath(New Pen(Color.Red, 2), myPath)
End Sub

Hinweise

Die Transformation kann die GraphicsPathskalieren, übersetzen, drehen oder schief gestalten.