GraphicsPath.Transform(Matrix) Método

Definición

Espacio de nombres:

System.Drawing.Drawing2D

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v9.0.0-rc.2.24474.1

Source:

GraphicsPath.cs

Aplica una matriz de transformación a este GraphicsPath.

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)

Parámetros

matrix

Matrix

Un Matrix que representa la transformación que se va a aplicar.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, un objeto de evento OnPaint. El código realiza las siguientes acciones:

• Crea una ruta de acceso y agrega una elipse a la ruta de acceso.

• Dibuja la ruta de acceso a la pantalla.

• Crea una matriz de transformación para traducir la ruta de acceso 100 unidades en la dirección del eje X.

• Dibuja la ruta de acceso transformada a la pantalla.

Observe que la elipse original se dibuja en negro y la elipse transformada se dibuja en rojo.

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

Comentarios

La transformación puede escalar, traducir, girar o sesgar el GraphicsPath.