Graphics.TranslateTransform Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Cambia el origen del sistema de coordenadas anteponiendo la traslació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 traslación especificada a la matriz de transformación de este Graphics en el orden que se establece.
TranslateTransform(Single, Single)	Cambia el origen del sistema de coordenadas anteponiendo la traslació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 traslación especificada a la matriz de transformación de este Graphics en el orden que se establece.

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 traslación.

dy

Single

Coordenada y de la traslación.

order

MatrixOrder

Miembro de la enumeración MatrixOrder que especifica si la traslación se agrega o antepone 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 Paint controlador de eventos. El código realiza las siguientes acciones:

• Gira la matriz de transformación mundial de Windows Forms en 30,0 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 consiste en multiplicar la matriz de transformación por una matriz cuya parte de traducción es los dx parámetros y dy . Este método antepone o anexa la matriz de transformación de por la matriz de Graphics traducción según el order parámetro .

Consulte también

• Sistemas de coordenadas y transformaciones
• Usar transformaciones en la interfaz GDI+ administrada

TranslateTransform(Single, Single)

Source:

Graphics.cs

Cambia el origen del sistema de coordenadas anteponiendo la traslació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 traslación.

dy

Single

Coordenada y de la traslació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 Paint controlador de eventos. El código realiza las siguientes acciones:

• Gira la matriz de transformación mundial de Windows Forms en 30,0 grados.

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

• 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 consiste en multiplicar la matriz de transformación por una matriz cuya parte de traducción es los dx parámetros y dy . Este método aplica la traducción anteponiendo la matriz de traducción a la matriz de transformación.

Consulte también

• Sistemas de coordenadas y transformaciones
• Usar transformaciones en la interfaz GDI+ administrada