Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Matrix.TranslatePrepend Method

Prepends a translation of the specified offsets to this Matrix structure.

Namespace:  System.Windows.Media
Assembly:  WindowsBase (in WindowsBase.dll)

public void TranslatePrepend(
	double offsetX,
	double offsetY
)

Parameters

offsetX
Type: System.Double

The amount to offset this Matrix along the x-axis.

offsetY
Type: System.Double

The amount to offset this Matrix along the y-axis.

In a composite transformation, the order of individual transformations is important. For example, if you first rotate, then scale, then translate, you get a different result than if you first translate, then rotate, then scale. One reason order is significant is that transformations like rotation and scaling are done with respect to the origin of the coordinate system. Scaling an object that is centered at the origin produces a different result than scaling an object that has been moved away from the origin. Similarly, rotating an object that is centered at the origin produces a different result than rotating an object that has been moved away from the origin.

The following example shows how prepend a translation onto a Matrix structure.

private Matrix translatePrependExample()
{

    Matrix myMatrix = new Matrix(5, 10, 15, 20, 25, 30);

    myMatrix.TranslatePrepend(5, 10);


    // myMatrix is equal to (5, 10, 15, 20, 200, 280). 
    return myMatrix;

}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft