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

정의

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)

지정된 순서로 Graphics의 변환 매트릭스에 지정된 변환을 적용하여 좌표계의 원점을 변경합니다.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)

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)

지정된 순서로 Graphics의 변환 매트릭스에 지정된 변환을 적용하여 좌표계의 원점을 변경합니다.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)

매개 변수

dx
Single Single Single Single

변환의 X좌표입니다.The x-coordinate of the translation.

dy
Single Single Single Single

변환의 Y좌표입니다.The y-coordinate of the translation.

order
MatrixOrder MatrixOrder MatrixOrder MatrixOrder

해당 이동이 변환 매트릭스의 앞에 추가될지 또는 뒤에 추가될지를 지정하는 MatrixOrder 열거형의 멤버입니다.Member of the MatrixOrder enumeration that specifies whether the translation is prepended or appended to the transformation matrix.

예제

다음 코드 예제는 Windows Forms에서 사용 하도록 설계 되었으며 필요 PaintEventArgs e의 매개 변수는 Paint 이벤트 처리기입니다.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 이 코드에서는 다음 작업을 수행합니다.The code performs the following actions:

  • Windows Form의 월드 변형 매트릭스를 30.0F도 회전 시킵니다.Rotates the world transformation matrix of the Windows Form by 30.0F degrees.

  • 그래픽 개체의 원본 호출 하 여 이동 TranslateTransform, 월드 변형 매트릭스에 번역을 추가 합니다.Moves the graphics object's origin by calling TranslateTransform, appending the translation to the world transformation matrix.

  • 파란색 펜으로 회전 되 고 번역 된 타원을 그립니다.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

설명

이동 된 행렬으로 변환 매트릭스 변환 작업으로 구성 합니다 dxdy 매개 변수입니다.The translation operation consists of multiplying the transformation matrix by a matrix whose translation part is the dx and dy parameters. 이 메서드 앞에 추가 하거나의 변형 매트릭스를 추가 합니다 Graphics 에 따라 변환 매트릭스를 order 매개 변수입니다.This method prepends or appends the transformation matrix of the Graphics by the translation matrix according to the order parameter.

추가 정보

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

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)

매개 변수

dx
Single Single Single Single

변환의 X좌표입니다.The x-coordinate of the translation.

dy
Single Single Single Single

변환의 Y좌표입니다.The y-coordinate of the translation.

예제

다음 코드 예제는 Windows Forms에서 사용 하도록 설계 되었으며 필요 PaintEventArgs e의 매개 변수는 Paint 이벤트 처리기입니다.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 이 코드에서는 다음 작업을 수행합니다.The code performs the following actions:

  • Windows Form의 월드 변형 매트릭스를 30.0F도 회전 시킵니다.Rotates the world transformation matrix of the Windows Form by 30.0F degrees.

  • Graphics 개체의 출처를 호출 하 여 이동 TranslateTransform를 번역에 변형 매트릭스 앞에 추가 합니다.Moves the origin of the graphics object by calling TranslateTransform, prepending the translation to the transformation matrix.

  • 파란색 펜을 사용 하 여 변환, 회전 타원을 그립니다.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

다음 그림에서는 이전 코드 예제를 실행 하는 출력을 보여줍니다.The following illustration shows the output of running the previous code example.

번역 및 변형 된 타원Translated and transformed ellipse

설명

출처는 일반적으로 그리기 화면의 왼쪽 위 모퉁이.The origin is typically the upper-left-hand corner of the drawing surface. 이동 된 행렬으로 변환 매트릭스 변환 작업으로 구성 합니다 dxdy 매개 변수입니다.The translation operation consists of multiplying the transformation matrix by a matrix whose translation part is the dx and dy parameters. 이 메서드를 변환 매트릭스 변환 행렬을 추가 하 여 변환 적용 됩니다.This method applies the translation by prepending the translation matrix to the transformation matrix.

추가 정보

적용 대상