Pen.RotateTransform 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.
Rotates the local geometric transformation by the specified angle. This method prepends the rotation to the transformation.
Overloads
| RotateTransform(Single, MatrixOrder) |
Rotates the local geometric transformation by the specified angle in the specified order. |
| RotateTransform(Single) |
Rotates the local geometric transformation by the specified angle. This method prepends the rotation to the transformation. |
RotateTransform(Single, MatrixOrder)
- Source:
- Pen.cs
- Source:
- Pen.cs
- Source:
- Pen.cs
Rotates the local geometric transformation by the specified angle in the specified order.
public:
void RotateTransform(float angle, System::Drawing::Drawing2D::MatrixOrder order);public void RotateTransform (float angle, System.Drawing.Drawing2D.MatrixOrder order);member this.RotateTransform : single * System.Drawing.Drawing2D.MatrixOrder -> unitPublic Sub RotateTransform (angle As Single, order As MatrixOrder)Parameters
- angle
- Single
The angle of rotation.
- order
- MatrixOrder
A MatrixOrder that specifies whether to append or prepend the rotation matrix.
Examples
The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:
Creates a Pen.
Scales the pen by 2 times in the x-axis direction.
Draws a rectangle using the pen.
Rotates the pen 90 degrees clockwise.
Draws a second rectangle to demonstrate the difference.
public:
void RotateTransform_Example2( PaintEventArgs^ e )
{
// Create a Pen object.
Pen^ rotatePen = gcnew Pen( Color::Black,5.0f );
// Scale rotatePen by 2X in the x-direction.
rotatePen->ScaleTransform( 2, 1 );
// Draw a rectangle with rotatePen.
e->Graphics->DrawRectangle( rotatePen, 10, 10, 100, 100 );
// Rotate rotatePen 90 degrees clockwise.
rotatePen->RotateTransform( 90, MatrixOrder::Append );
// Draw a second rectangle with rotatePen.
e->Graphics->DrawRectangle( rotatePen, 120, 10, 100, 100 );
}
public void RotateTransform_Example2(PaintEventArgs e)
{
// Create a Pen object.
Pen rotatePen = new Pen(Color.Black, 5);
// Scale rotatePen by 2X in the x-direction.
rotatePen.ScaleTransform(2, 1);
// Draw a rectangle with rotatePen.
e.Graphics.DrawRectangle(rotatePen, 10, 10, 100, 100);
// Rotate rotatePen 90 degrees clockwise.
rotatePen.RotateTransform(90, MatrixOrder.Append);
// Draw a second rectangle with rotatePen.
e.Graphics.DrawRectangle(rotatePen, 120, 10, 100, 100);
}
Public Sub RotateTransform_Example2(ByVal e As PaintEventArgs)
' Create a Pen object.
Dim rotatePen As New Pen(Color.Black, 5)
' Scale rotatePen by 2X in the x-direction.
rotatePen.ScaleTransform(2, 1)
' Draw a rectangle with rotatePen.
e.Graphics.DrawRectangle(rotatePen, 10, 10, 100, 100)
' Rotate rotatePen 90 degrees clockwise.
rotatePen.RotateTransform(90, MatrixOrder.Append)
' Draw a second rectangle with rotatePen.
e.Graphics.DrawRectangle(rotatePen, 120, 10, 100, 100)
End Sub
Remarks
Because the shape of a pen is circular, a rotation does not have any visible effect unless the pen is scaled in the x- or y-axis direction.
Applies to
RotateTransform(Single)
- Source:
- Pen.cs
- Source:
- Pen.cs
- Source:
- Pen.cs
Rotates the local geometric transformation by the specified angle. This method prepends the rotation to the transformation.
public:
void RotateTransform(float angle);public void RotateTransform (float angle);member this.RotateTransform : single -> unitPublic Sub RotateTransform (angle As Single)Parameters
- angle
- Single
The angle of rotation.
Examples
The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:
Creates a Pen.
Draws a rectangle using the pen.
Scales the pen by 2 times in the x-axis direction.
Rotates the pen 90 degrees clockwise.
Draws a second rectangle to demonstrate the difference.
public:
void RotateTransform_Example1( PaintEventArgs^ e )
{
// Create a Pen object.
Pen^ rotatePen = gcnew Pen( Color::Black,5.0f );
// Draw a rectangle with rotatePen.
e->Graphics->DrawRectangle( rotatePen, 10, 10, 100, 100 );
// Scale rotatePen by 2X in the x-direction.
rotatePen->ScaleTransform( 2, 1 );
// Rotate rotatePen 90 degrees clockwise.
rotatePen->RotateTransform( 90 );
// Draw a second rectangle with rotatePen.
e->Graphics->DrawRectangle( rotatePen, 140, 10, 100, 100 );
}
public void RotateTransform_Example1(PaintEventArgs e)
{
// Create a Pen object.
Pen rotatePen = new Pen(Color.Black, 5);
// Draw a rectangle with rotatePen.
e.Graphics.DrawRectangle(rotatePen, 10, 10, 100, 100);
// Scale rotatePen by 2X in the x-direction.
rotatePen.ScaleTransform(2, 1);
// Rotate rotatePen 90 degrees clockwise.
rotatePen.RotateTransform(90);
// Draw a second rectangle with rotatePen.
e.Graphics.DrawRectangle(rotatePen, 140, 10, 100, 100);
}
Public Sub RotateTransform_Example1(ByVal e As PaintEventArgs)
' Create a Pen object.
Dim rotatePen As New Pen(Color.Black, 5)
' Draw a rectangle with rotatePen.
e.Graphics.DrawRectangle(rotatePen, 10, 10, 100, 100)
' Scale rotatePen by 2X in the x-direction.
rotatePen.ScaleTransform(2, 1)
' Rotate rotatePen 90 degrees clockwise.
rotatePen.RotateTransform(90)
' Draw a second rectangle with rotatePen.
e.Graphics.DrawRectangle(rotatePen, 140, 10, 100, 100)
End Sub
Remarks
Because the shape of a pen is circular, a rotation does not have any visible effect unless the pen is scaled in the x- or y-axis direction.
