Graphics.TranslateTransform Graphics.TranslateTransform Graphics.TranslateTransform Graphics.TranslateTransform Method

Definición

Cambia el origen del sistema de coordenadas anteponiendo la traslación especificada a la matriz de transformación de este Graphics.Changes the origin of the coordinate system by prepending the specified translation to the transformation matrix of this Graphics.

Sobrecargas

TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) 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.Changes the origin of the coordinate system by applying the specified translation to the transformation matrix of this Graphics in the specified order.

TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single)

Cambia el origen del sistema de coordenadas anteponiendo la traslación especificada a la matriz de transformación de este Graphics.Changes the origin of the coordinate system by prepending the specified translation to the transformation matrix of this Graphics.

TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) 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.Changes the origin of the coordinate system by applying the specified translation to the transformation matrix of this Graphics in the specified order.

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 Single Single Single

Coordenada x de la traslación.The x-coordinate of the translation.

dy
Single Single Single Single

Coordenada y de la traslación.The y-coordinate of the translation.

order
MatrixOrder MatrixOrder MatrixOrder MatrixOrder

Miembro de la enumeración MatrixOrder que especifica si la traslación se agrega o antepone a la matriz de transformación.Member of the MatrixOrder enumeration that specifies whether the translation is prepended or appended to the transformation matrix.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Gira la matriz de transformación universal del formulario de Windows 30,0 F grados.Rotates the world transformation matrix of the Windows Form by 30.0F degrees.

  • Mueve el origen del objeto gráfico llamando TranslateTransforma, anexando la traslación a la matriz de transformación universal.Moves the graphics object's origin by calling TranslateTransform, appending the translation to the world transformation matrix.

  • Dibuja una elipse girada y traducida con un lápiz azul.Draws a rotated, translated ellipse with a blue pen.

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 traslación consiste en multiplicar la matriz de transformación por una matriz cuya parte dx de dy traducción es los parámetros y.The translation operation consists of multiplying the transformation matrix by a matrix whose translation part is the dx and dy parameters. Este método antepone o anexa la matriz de transformación de la Graphics matriz de traslación según el order parámetro.This method prepends or appends the transformation matrix of the Graphics by the translation matrix according to the order parameter.

Consulte también:

TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single)

Cambia el origen del sistema de coordenadas anteponiendo la traslación especificada a la matriz de transformación de este Graphics.Changes the origin of the coordinate system by prepending the specified translation to the transformation matrix of this 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 Single Single Single

Coordenada x de la traslación.The x-coordinate of the translation.

dy
Single Single Single Single

Coordenada y de la traslación.The y-coordinate of the translation.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Gira la matriz de transformación universal del formulario de Windows 30,0 F grados.Rotates the world transformation matrix of the Windows Form by 30.0F degrees.

  • Mueve el origen del objeto Graphics llamando TranslateTransforma, anteponiendo la conversión a la matriz de transformación.Moves the origin of the graphics object by calling TranslateTransform, prepending the translation to the transformation matrix.

  • Dibuja una elipse traducida y girada con un lápiz azul.Draws a translated, rotated ellipse with a blue pen.

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.The following illustration shows the output of running the previous code example.

![Elipse traducida y transformada] (~/add/media/ndp-tranlatetransform.png "Elipse traducida y transformada")Translated and transformed ellipse

Comentarios

El origen es normalmente la esquina superior izquierda de la superficie de dibujo.The origin is typically the upper-left-hand corner of the drawing surface. La operación de traslación consiste en multiplicar la matriz de transformación por una matriz cuya parte dx de dy traducción es los parámetros y.The translation operation consists of multiplying the transformation matrix by a matrix whose translation part is the dx and dy parameters. Este método aplica la traducción anteponiendo la matriz de traslación a la matriz de transformación.This method applies the translation by prepending the translation matrix to the transformation matrix.

Consulte también:

Se aplica a