LinearGradientBrush.RotateTransform Method

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Rotates the local geometric transform by the specified amount. This method prepends the rotation to the transform.

Overloads

RotateTransform(Single)	Rotates the local geometric transform by the specified amount. This method prepends the rotation to the transform.
RotateTransform(Single, MatrixOrder)	Rotates the local geometric transform by the specified amount in the specified order.

RotateTransform(Single)

Rotates the local geometric transform by the specified amount. This method prepends the rotation to the transform.

public:
 void RotateTransform(float angle);

public void RotateTransform (float angle);

member this.RotateTransform : single -> unit

Public Sub RotateTransform (angle As Single)

Parameters

angle

Single

The angle of rotation.

Examples

For an example, see RotateTransform.

RotateTransform(Single, MatrixOrder)

Rotates the local geometric transform by the specified amount 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 -> unit

Public 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, an OnPaint event object. The code

• Creates a new LinearGradientBrush.

• Draws an ellipse to the screen using this brush.

• Rotates the LinearGradientBrush 45 degrees by calling the RotateTransform method.

• Draws an ellipse to the screen directly below the first ellipse, using the rotated brush.

Notice that the gradient of the lower ellipse is at a 45 degree angle to the x-axis of the top ellipse. Also notice that a call to the TranslateTransform method is used to justify the left edge of the gradient fill with the left edge of the lower ellipse.

private:
   void RotateTransformExample( PaintEventArgs^ e )
   {
      // Create a LinearGradientBrush.
      Rectangle myRect = Rectangle(20,20,200,100);
      LinearGradientBrush^ myLGBrush = gcnew LinearGradientBrush( myRect,Color::Blue,Color::Red,0.0f,true );

      // Draw an ellipse to the screen using the LinearGradientBrush.
      e->Graphics->FillEllipse( myLGBrush, myRect );

      // Rotate the LinearGradientBrush.
      myLGBrush->RotateTransform( 45.0f, MatrixOrder::Prepend );

      // Rejustify the brush to start at the left edge of the ellipse.
      myLGBrush->TranslateTransform(  -100.0f, 0.0f );

      // Draw a second ellipse to the screen using
      // the transformed brush.
      e->Graphics->FillEllipse( myLGBrush, 20, 150, 200, 100 );
   }

 private void RotateTransformExample(PaintEventArgs e)
 {
              
     // Create a LinearGradientBrush.
     Rectangle myRect = new Rectangle(20, 20, 200, 100);
     LinearGradientBrush myLGBrush = new LinearGradientBrush(
         myRect, Color.Blue, Color.Red,  0.0f, true);
              
     // Draw an ellipse to the screen using the LinearGradientBrush.
     e.Graphics.FillEllipse(myLGBrush, myRect);
              
     // Rotate the LinearGradientBrush.
     myLGBrush.RotateTransform(45.0f, MatrixOrder.Prepend);

     // Rejustify the brush to start at the left edge of the ellipse.
     myLGBrush.TranslateTransform(-100.0f, 0.0f);
              
     // Draw a second ellipse to the screen using
     // the transformed brush.
     e.Graphics.FillEllipse(myLGBrush, 20, 150, 200, 100);
 }

Public Sub RotateTransformExample(ByVal e As PaintEventArgs)

    ' Create a LinearGradientBrush.
    Dim myRect As New Rectangle(20, 20, 200, 100)
    Dim myLGBrush As New LinearGradientBrush(myRect, Color.Blue, _
    Color.Red, 0.0F, True)

    ' Draw an ellipse to the screen using the LinearGradientBrush.
    e.Graphics.FillEllipse(myLGBrush, myRect)

    ' Rotate the LinearGradientBrush.
    myLGBrush.RotateTransform(45.0F, MatrixOrder.Prepend)

    ' Rejustify the brush to start at the left edge of the ellipse.
    myLGBrush.TranslateTransform(-100.0F, 0.0F)

    ' Draw a second ellipse to the screen using the transformed brush.
    e.Graphics.FillEllipse(myLGBrush, 20, 150, 200, 100)
End Sub