Graphics.TranslateTransform Метод

Определение

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

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

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