Graphics.TranslateTransform Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

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

Cambia el origen del sistema de coordenadas anteponiendo la traducción especificada a la matriz de transformación de este Graphics.

Sobrecargas

TranslateTransform(Single, Single, MatrixOrder)	Cambia el origen del sistema de coordenadas aplicando la traducción especificada a la matriz de transformación de este Graphics en el orden especificado.
TranslateTransform(Single, Single)	Cambia el origen del sistema de coordenadas anteponiendo la traducción especificada a la matriz de transformación de este Graphics.

TranslateTransform(Single, Single, MatrixOrder)

Source:

Graphics.cs

Cambia el origen del sistema de coordenadas aplicando la traducción especificada a la matriz de transformación de este Graphics en el orden especificado.

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)

Parámetros

dx

Single

Coordenada x de la traducción.

dy

Single

Coordenada y de la traducción.

order

MatrixOrder

Miembro de la enumeración MatrixOrder que especifica si la traducción se antepone o anexa a la matriz de transformación.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• Gira la matriz de transformación del mundo de Windows Form en 30,0F grados.

• Mueve el origen del objeto gráfico llamando a TranslateTransform, anexando la traducción a la matriz de transformación del mundo.

• Dibuja una elipse rotada traducida con un lápiz azul.

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

Comentarios

La operación de traducción consta de multiplicar la matriz de transformación por una matriz cuya parte de traducción es el dx y dy parámetros. Este método antepone o anexa la matriz de transformación de la Graphics por la matriz de traducción según el parámetro order.

Consulte también

• sistemas y transformaciones de coordenadas de
• uso de transformaciones en GDI+ administrado

TranslateTransform(Single, Single)

Source:

Graphics.cs

Cambia el origen del sistema de coordenadas anteponiendo la traducción especificada a la matriz de transformación de este Graphics.

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)

Parámetros

dx

Single

Coordenada x de la traducción.

dy

Single

Coordenada y de la traducción.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• Gira la matriz de transformación del mundo de Windows Form en 30,0F grados.

• Mueve el origen del objeto gráfico llamando a TranslateTransform, prepending the translation to the transformation matrix.

• Dibuja una elipse traducida girada con un lápiz azul.

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

En la ilustración siguiente se muestra la salida de la ejecución del ejemplo de código anterior.

Comentarios

El origen suele ser la esquina superior izquierda de la superficie de dibujo. La operación de traducción consta de multiplicar la matriz de transformación por una matriz cuya parte de traducción es el dx y dy parámetros. Este método aplica la traducción anteponiendo la matriz de traducción a la matriz de transformación.

Consulte también

• sistemas y transformaciones de coordenadas de
• uso de transformaciones en GDI+ administrado