Graphics.TranslateTransform Метод

Определение

Изменяет источник системы координат путем подготовки указанного перевода к матрице преобразования этого Graphics.

Перегрузки

TranslateTransform(Single, Single)

Изменяет источник системы координат путем подготовки указанного перевода к матрице преобразования этого Graphics.

TranslateTransform(Single, Single, MatrixOrder)

Изменяет источник системы координат, применяя указанный перевод к матрице преобразования этого Graphics в указанном порядке.

TranslateTransform(Single, Single)

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Изменяет источник системы координат путем подготовки указанного перевода к матрице преобразования этого 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

Координата x перевода.

dy
Single

Координата y перевода.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

  • Поворот матрицы преобразования мира формы Windows Form на 30,0F градусов.

  • Перемещает источник графического объекта путем вызова TranslateTransform, предустановив перевод в матрицу преобразования.

  • Рисует переведенное, вращаемое многоточие с синим пером.

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

На следующем рисунке показаны выходные данные выполнения предыдущего примера кода.

переведенные и преобразованные многоточие

Комментарии

Источник обычно является верхним левым углом поверхности рисования. Операция перевода состоит из умножения матрицы преобразования на матрицу, часть перевода которой является dx и dy параметров. Этот метод применяет перевод путем подготовки матрицы перевода к матрице преобразования.

См. также раздел

Применяется к

TranslateTransform(Single, Single, MatrixOrder)

Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs
Исходный код:
Graphics.cs

Изменяет источник системы координат, применяя указанный перевод к матрице преобразования этого Graphics в указанном порядке.

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

Координата x перевода.

dy
Single

Координата y перевода.

order
MatrixOrder

Элемент перечисления MatrixOrder, указывающий, является ли перевод предустановленным или добавлен в матрицу преобразования.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

  • Поворот матрицы преобразования мира формы Windows Form на 30,0F градусов.

  • Перемещает источник графического объекта путем вызова TranslateTransform, добавляя перевод в матрицу преобразования мира.

  • Рисует повернутый, переведенный многоточие с синим пером.

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

Комментарии

Операция перевода состоит из умножения матрицы преобразования на матрицу, часть перевода которой является dx и dy параметров. Этот метод предопределен или добавляет матрицу преобразования Graphics матрицей перевода в соответствии с параметром order.

См. также раздел

Применяется к