Rect.Transform Method

Definition

Namespace:

System.Windows

Assembly:

WindowsBase.dll

Transforms a rectangle by using the specified matrix.

Overloads

Transform(Matrix)	Transforms the rectangle by applying the specified matrix.
Transform(Rect, Matrix)	Returns the rectangle that results from applying the specified matrix to the specified rectangle.

Transform(Matrix)

Transforms the rectangle by applying the specified matrix.

public:
 void Transform(System::Windows::Media::Matrix matrix);

public void Transform (System.Windows.Media.Matrix matrix);

member this.Transform : System.Windows.Media.Matrix -> unit

Public Sub Transform (matrix As Matrix)

Parameters

matrix

Matrix

A matrix that specifies the transformation to apply.

Examples

The following example shows how to use the Transform(Matrix) method to transform a Rect structure by using a Matrix.

private Rect transformExample1()
{
    // Initialize new rectangle.
    Rect myRectangle = new Rect();

    // Set the Size property of the rectangle with a width of 200
    // and a height of 60.
    myRectangle.Size = new Size(200, 60);

    // Creating a Matrix structure.
    Matrix myMatrix = new Matrix(0, 1, 1, 0, 20, 2);

    // The Transform method transforms this rectangle using the specified matrix.  
    // myRectangle location changed from 0,0 to 20, 2 and the size changed from
    // 200,60 to 60,200.
    myRectangle.Transform(myMatrix);

    return myRectangle;
}

Transform(Rect, Matrix)

Returns the rectangle that results from applying the specified matrix to the specified rectangle.

public:
 static System::Windows::Rect Transform(System::Windows::Rect rect, System::Windows::Media::Matrix matrix);

public static System.Windows.Rect Transform (System.Windows.Rect rect, System.Windows.Media.Matrix matrix);

static member Transform : System.Windows.Rect * System.Windows.Media.Matrix -> System.Windows.Rect

Public Shared Function Transform (rect As Rect, matrix As Matrix) As Rect

Parameters

rect

Rect

A rectangle that is the basis for the transformation.

matrix

Matrix

A matrix that specifies the transformation to apply.

Returns

Rect

The rectangle that results from the operation.

Examples

The following example shows how to use the Transform(Rect, Matrix) method to create a new Rect structure that results from applying a Matrix to an existing rectangle.

private Rect transformExample2()
{
    // Initialize new rectangle.
    Rect myRectangle = new Rect();

    // Set the Size property of the rectangle with a width of 200
    // and a height of 60.
    myRectangle.Size = new Size(200, 60);

    // Creating a Matrix structure.
    Matrix myMatrix = new Matrix(0, 1, 1, 0, 20, 2);

    // The Transform method Transforms the specified rectangle using the specified matrix 
    // and returns the results.  
    // resultRect is an alterned version of myRectangle with a location of 20,2 rather
    // then 0,0 and a size of 60,200 rather then 200,60.
    Rect resultRect = Rect.Transform(myRectangle,myMatrix);

    return resultRect;
}