Pen::RotateTransform Method (Single, MatrixOrder)
.NET Framework (current version)
Rotates the local geometric transformation by the specified angle in the specified order.
Assembly: System.Drawing (in System.Drawing.dll)
Parameters
- angle
-
Type:
System::Single
The angle of rotation.
- order
-
Type:
System.Drawing.Drawing2D::MatrixOrder
A MatrixOrder that specifies whether to append or prepend the rotation matrix.
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.
The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, 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 ); }
.NET Framework
Available since 1.1
Available since 1.1
Show: