# Matrix.Translate Method

## Definition

Important

Some information relates to prerelease product that may be substantially modified before itâ€™s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Applies the specified translation vector to this Matrix by prepending the translation vector.

## Overloads

Translate(Single, Single) |
Applies the specified translation vector ( |

Translate(Single, Single, MatrixOrder) |
Applies the specified translation vector to this Matrix in the specified order. |

## Translate(Single, Single)

- Source:
- Matrix.cs

- Source:
- Matrix.cs

- Source:
- Matrix.cs

- Source:
- Matrix.cs

- Source:
- Matrix.cs

Applies the specified translation vector (`offsetX`

and `offsetY`

) to this Matrix by prepending the translation vector.

```
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)`

#### Parameters

### Examples

For an example, see Translate(Single, Single, MatrixOrder).

### Applies to

## Translate(Single, Single, MatrixOrder)

- Source:
- Matrix.cs

- Source:
- Matrix.cs

- Source:
- Matrix.cs

- Source:
- Matrix.cs

- Source:
- Matrix.cs

Applies the specified translation vector to this Matrix in the specified order.

```
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)`

#### Parameters

- order
- MatrixOrder

A MatrixOrder that specifies the order (append or prepend) in which the translation is applied to this Matrix.

### Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs `e`

, an Paint event object. The code performs the following actions:

Draws a rectangle to the screen prior to applying a translate transform (the blue rectangle).

Creates a matrix and translates it by 100 in both axes.

Applies this matrix transform to the rectangle,

Draws the transformed rectangle to the screen (the red rectangle).

Notice that the beginning of the red rectangle is located 100 points in both axes from the beginning of the blue triangle.

```
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
```

### Applies to

## Feedback

https://aka.ms/ContentUserFeedback.

Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for