Pen::RotateTransform Method (Single, MatrixOrder)

 

Rotates the local geometric transformation by the specified angle in the specified order.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public:
void RotateTransform(
	float angle,
	MatrixOrder order
)

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
Return to top
Show: