Matrix.Translate Метод

Определение

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

System.Drawing.Drawing2D

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Применяет указанный вектор смещения к этому объекту Matrix, добавляя вектор смещения в начало.

Перегрузки

Translate(Single, Single)	Применяет указанный вектор смещения (offsetX и offsetY) к этому объекту Matrix, добавляя вектор смещения в начало.
Translate(Single, Single, MatrixOrder)	Применяет указанный вектор смещения к этому объекту Matrix в указанном порядке.

Translate(Single, Single)

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

Matrix.cs

Применяет указанный вектор смещения (offsetX и offsetY) к этому объекту Matrix, добавляя вектор смещения в начало.

public:
 void Translate(float offsetX, float offsetY);

public void Translate (float offsetX, float offsetY);

member this.Translate : single * single -> unit

Public Sub Translate (offsetX As Single, offsetY As Single)

Параметры

offsetX

Single

Значение X, на которое смещается этот объект Matrix.

offsetY

Single

Значение Y, на которое смещается этот объект Matrix.

Примеры

Пример см. в разделе Translate(Single, Single, MatrixOrder).

Translate(Single, Single, MatrixOrder)

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

Matrix.cs

Применяет указанный вектор смещения к этому объекту Matrix в указанном порядке.

public:
 void Translate(float offsetX, float offsetY, System::Drawing::Drawing2D::MatrixOrder order);

public void Translate (float offsetX, float offsetY, System.Drawing.Drawing2D.MatrixOrder order);

member this.Translate : single * single * System.Drawing.Drawing2D.MatrixOrder -> unit

Public Sub Translate (offsetX As Single, offsetY As Single, order As MatrixOrder)

Параметры

offsetX

Single

Значение X, на которое смещается этот объект Matrix.

offsetY

Single

Значение Y, на которое смещается этот объект Matrix.

order

MatrixOrder

Объект MatrixOrder, задающий порядок (в конце или в начале), в котором применяется смещение к этому объекту Matrix.

Примеры

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

• Рисует прямоугольник на экране перед применением преобразования преобразования (синий прямоугольник).

• Создает матрицу и преобразует ее на 100 в обеих осях.

• Применяет это преобразование матрицы к прямоугольнику.

• Рисует преобразованный прямоугольник на экране (красный прямоугольник).

Обратите внимание, что начало красного прямоугольника находится в 100 точках обеих осей от начала синего треугольника.

public:
   void TranslateExample( PaintEventArgs^ e )
   {
      Pen^ myPen = gcnew Pen( Color::Blue,1.0f );
      Pen^ myPen2 = gcnew Pen( Color::Red,1.0f );

      // Draw a rectangle to the screen before applying the
      // transform.
      e->Graphics->DrawRectangle( myPen, 20, 20, 100, 50 );

      // Create a matrix and translate it.
      Matrix^ myMatrix = gcnew Matrix;
      myMatrix->Translate( 100, 100, MatrixOrder::Append );

      // Draw the Points to the screen again after applying the
      // transform.
      e->Graphics->Transform = myMatrix;
      e->Graphics->DrawRectangle( myPen2, 20, 20, 100, 50 );
   }

public void TranslateExample(PaintEventArgs e)
{
    Pen myPen = new Pen(Color.Blue, 1);
    Pen myPen2 = new Pen(Color.Red, 1);
             
    // Draw a rectangle to the screen before applying the
    // transform.
    e.Graphics.DrawRectangle(myPen, 20, 20, 100, 50);
             
    // Create a matrix and translate it.
    Matrix myMatrix = new Matrix();
    myMatrix.Translate(100, 100, MatrixOrder.Append);
             
    // Draw the Points to the screen again after applying the
    // transform.
    e.Graphics.Transform = myMatrix;
    e.Graphics.DrawRectangle(myPen2, 20, 20, 100, 50);
}

Public Sub TranslateExample(ByVal e As PaintEventArgs)
    Dim myPen As New Pen(Color.Blue, 1)
    Dim myPen2 As New Pen(Color.Red, 1)

    ' Draw a rectangle to the screen before applying the
    ' transform.
    e.Graphics.DrawRectangle(myPen, 20, 20, 100, 50)

    ' Create a matrix and translate it.
    Dim myMatrix As New Matrix
    myMatrix.Translate(100, 100, MatrixOrder.Append)

    ' Draw the Points to the screen again after applying the
    ' transform.
    e.Graphics.Transform = myMatrix
    e.Graphics.DrawRectangle(myPen2, 20, 20, 100, 50)
End Sub