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

Definizione

Modifica l'origine del sistema di coordinate anteponendo la traslazione specificata alla matrice di trasformazione di questo oggetto Graphics.Changes the origin of the coordinate system by prepending the specified translation to the transformation matrix of this Graphics.

Overload

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

Modifica l'origine del sistema di coordinate applicando la traslazione specificata alla matrice di trasformazione di questo oggetto Graphics nell'ordine indicato.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)

Modifica l'origine del sistema di coordinate anteponendo la traslazione specificata alla matrice di trasformazione di questo oggetto 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)

Modifica l'origine del sistema di coordinate applicando la traslazione specificata alla matrice di trasformazione di questo oggetto Graphics nell'ordine indicato.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)

Parametri

dx
Single Single Single Single

Coordinata x della traslazione.The x-coordinate of the translation.

dy
Single Single Single Single

Coordinata y della traslazione.The y-coordinate of the translation.

order
MatrixOrder MatrixOrder MatrixOrder MatrixOrder

Membro dell'enumerazione MatrixOrder che specifica se l'operazione di traslazione è anteposta o accodata alla matrice di trasformazione.Member of the MatrixOrder enumeration that specifies whether the translation is prepended or appended to the transformation matrix.

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Ruota la matrice di trasformazione globale di Windows Form per 30 F Degrees.Rotates the world transformation matrix of the Windows Form by 30.0F degrees.

  • Sposta l'origine dell'oggetto Graphics chiamando TranslateTransform, accodando la conversione alla matrice di trasformazione mondiale.Moves the graphics object's origin by calling TranslateTransform, appending the translation to the world transformation matrix.

  • Disegna un'ellisse traslata e traslata con una penna blu.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

Commenti

L'operazione di conversione consiste nel moltiplicare la matrice di trasformazione in base a una matrice la dx cui dy parte della traduzione è costituita dai parametri e.The translation operation consists of multiplying the transformation matrix by a matrix whose translation part is the dx and dy parameters. Questo metodo antepone o aggiunge la matrice di trasformazione di Graphics dalla matrice di traslazione order in base al parametro.This method prepends or appends the transformation matrix of the Graphics by the translation matrix according to the order parameter.

Vedi anche

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

Modifica l'origine del sistema di coordinate anteponendo la traslazione specificata alla matrice di trasformazione di questo oggetto 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)

Parametri

dx
Single Single Single Single

Coordinata x della traslazione.The x-coordinate of the translation.

dy
Single Single Single Single

Coordinata y della traslazione.The y-coordinate of the translation.

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Ruota la matrice di trasformazione globale di Windows Form per 30 F Degrees.Rotates the world transformation matrix of the Windows Form by 30.0F degrees.

  • Sposta l'origine dell'oggetto Graphics chiamando TranslateTransform, anteponendo la traduzione alla matrice di trasformazione.Moves the origin of the graphics object by calling TranslateTransform, prepending the translation to the transformation matrix.

  • Disegna un'ellisse traslata, ruotata con una penna blu.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

La figura seguente mostra l'output dell'esecuzione dell'esempio di codice precedente.The following illustration shows the output of running the previous code example.

![Ellisse convertita e trasformata] (~/add/media/ndp-tranlatetransform.png "Ellisse convertita e trasformata")Translated and transformed ellipse

Commenti

L'origine è in genere l'angolo superiore sinistro della superficie di disegno.The origin is typically the upper-left-hand corner of the drawing surface. L'operazione di conversione consiste nel moltiplicare la matrice di trasformazione in base a una matrice la dx cui dy parte della traduzione è costituita dai parametri e.The translation operation consists of multiplying the transformation matrix by a matrix whose translation part is the dx and dy parameters. Questo metodo applica la traduzione anteponendo la matrice di traslazione alla matrice di trasformazione.This method applies the translation by prepending the translation matrix to the transformation matrix.

Vedi anche

Si applica a