# Matrix.TransformPointsMatrix.TransformPointsMatrix.TransformPointsMatrix.TransformPoints Method

## Definition

Applies the geometric transform this Matrix represents to an array of points.

 TransformPoints(Point[]) TransformPoints(Point[]) TransformPoints(Point[]) TransformPoints(Point[]) Applies the geometric transform represented by this Matrix to a specified array of points. TransformPoints(PointF[]) TransformPoints(PointF[]) TransformPoints(PointF[]) TransformPoints(PointF[]) Applies the geometric transform represented by this Matrix to a specified array of points.

## TransformPoints(Point[])TransformPoints(Point[])TransformPoints(Point[])TransformPoints(Point[])

Applies the geometric transform represented by this Matrix to a specified array of points.

``````public:
void TransformPoints(cli::array <System::Drawing::Point> ^ pts);``````
``public void TransformPoints (System.Drawing.Point[] pts);``
``member this.TransformPoints : System.Drawing.Point[] -> unit``
``Public Sub TransformPoints (pts As Point())``

#### Parameters

pts
Point[]

An array of Point structures that represents the points to transform.

### 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:

• Creates an array of points that form a rectangle.

• Draws this array of points (to the screen prior to applying a scaling transform (the blue rectangle).

• Creates a matrix and scales it by 3 in the x-axis and 2 in the y-axis.

• Applies this matrix transform to the array of points.

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

Notice that the red rectangle has been scaled by a factor of 3 in the x-axis and by 2 in the y-axis, including the upper left-hand corner of the rectangle (the beginning point of the rectangle).

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

// Create an array of points.
array<Point>^ myArray = {Point(20,20),Point(120,20),Point(120,120),Point(20,120),Point(20,20)};

// Draw the Points to the screen before applying the
// transform.
e->Graphics->DrawLines( myPen, myArray );

// Create a matrix and scale it.
Matrix^ myMatrix = gcnew Matrix;
myMatrix->Scale( 3, 2, MatrixOrder::Append );
myMatrix->TransformPoints( myArray );

// Draw the Points to the screen again after applying the
// transform.
e->Graphics->DrawLines( myPen2, myArray );
}
``````
``````public void TransformPointsExample(PaintEventArgs e)
{
Pen myPen = new Pen(Color.Blue, 1);
Pen myPen2 = new Pen(Color.Red, 1);

// Create an array of points.
Point[] myArray =
{
new Point(20, 20),
new Point(120, 20),
new Point(120, 120),
new Point(20, 120),
new Point(20,20)
};

// Draw the Points to the screen before applying the
// transform.
e.Graphics.DrawLines(myPen, myArray);

// Create a matrix and scale it.
Matrix myMatrix = new Matrix();
myMatrix.Scale(3, 2, MatrixOrder.Append);
myMatrix.TransformPoints(myArray);

// Draw the Points to the screen again after applying the
// transform.
e.Graphics.DrawLines(myPen2, myArray);
}
``````
``````Public Sub TransformPointsExample(ByVal e As PaintEventArgs)
Dim myPen As New Pen(Color.Blue, 1)
Dim myPen2 As New Pen(Color.Red, 1)

' Create an array of points.
Dim myArray As Point() = {New Point(20, 20), New Point(120, 20), _
New Point(120, 120), New Point(20, 120), New Point(20, 20)}

' Draw the Points to the screen before applying the
' transform.
e.Graphics.DrawLines(myPen, myArray)

' Create a matrix and scale it.
Dim myMatrix As New Matrix
myMatrix.Scale(3, 2, MatrixOrder.Append)
myMatrix.TransformPoints(myArray)

' Draw the Points to the screen again after applying the
' transform.
e.Graphics.DrawLines(myPen2, myArray)
End Sub
``````

## TransformPoints(PointF[])TransformPoints(PointF[])TransformPoints(PointF[])TransformPoints(PointF[])

Applies the geometric transform represented by this Matrix to a specified array of points.

``````public:
void TransformPoints(cli::array <System::Drawing::PointF> ^ pts);``````
``public void TransformPoints (System.Drawing.PointF[] pts);``
``member this.TransformPoints : System.Drawing.PointF[] -> unit``
``Public Sub TransformPoints (pts As PointF())``

#### Parameters

pts
PointF[]

An array of PointF structures that represents the points to transform.

### Examples

For an example, see TransformPoints(Point[]).