Graphics.TranslateTransform Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v9.0.0-preview.5.24306.5

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

Перегрузки

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

TranslateTransform(Single, Single, MatrixOrder)

Исходный код:

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.

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

• системы координат и преобразования
• использование преобразований в управляемых GDI+

TranslateTransform(Single, Single)

Исходный код:

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

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

• системы координат и преобразования
• использование преобразований в управляемых GDI+