Region.Transform(Matrix) Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Region.cs

Transformiert diese Region mit der angegebenen Matrix.

public:
 void Transform(System::Drawing::Drawing2D::Matrix ^ matrix);

public void Transform (System.Drawing.Drawing2D.Matrix matrix);

member this.Transform : System.Drawing.Drawing2D.Matrix -> unit

Public Sub Transform (matrix As Matrix)

Parameter

matrix

Matrix

Die Matrix, mit der diese Region transformiert werden soll.

Ausnahmen

ArgumentNullException

matrix ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

• Erstellt ein Rechteck und zeichnet es blau auf den Bildschirm.

• Erstellt einen Bereich aus dem Rechteck.

• Erstellt eine Transformationsmatrix und legt sie auf 45 Grad fest.

• Wendet die Transformation auf die Region an.

• Füllt den transformierten Bereich mit rot auf und zeichnet den transformierten Bereich rot auf den Bildschirm.

Beachten Sie, dass das rote Rechteck um 45 Grad vom ursprünglichen Rechteck gedreht ist( blau dargestellt).

public:
   void TransformExample( PaintEventArgs^ e )
   {
      
      // Create the first rectangle and draw it to the screen in blue.
      Rectangle regionRect = Rectangle(100,50,100,100);
      e->Graphics->DrawRectangle( Pens::Blue, regionRect );
      
      // Create a region using the first rectangle.
      System::Drawing::Region^ myRegion = gcnew System::Drawing::Region( regionRect );
      
      // Create a transform matrix and set it to have a 45 degree
      // rotation.
      Matrix^ transformMatrix = gcnew Matrix;
      transformMatrix->RotateAt( 45, Point(100,50) );
      
      // Apply the transform to the region.
      myRegion->Transform(transformMatrix);
      
      // Fill the transformed region with red and draw it to the screen
      // in red.
      SolidBrush^ myBrush = gcnew SolidBrush( Color::Red );
      e->Graphics->FillRegion( myBrush, myRegion );
   }

public void TransformExample(PaintEventArgs e)
{
             
    // Create the first rectangle and draw it to the screen in blue.
    Rectangle regionRect = new Rectangle(100, 50, 100, 100);
    e.Graphics.DrawRectangle(Pens.Blue, regionRect);
             
    // Create a region using the first rectangle.
    Region myRegion = new Region(regionRect);
             
    // Create a transform matrix and set it to have a 45 degree
             
    // rotation.
    Matrix transformMatrix = new Matrix();
    transformMatrix.RotateAt(45, new Point(100, 50));
             
    // Apply the transform to the region.
    myRegion.Transform(transformMatrix);
             
    // Fill the transformed region with red and draw it to the screen
             
    // in red.
    SolidBrush myBrush = new SolidBrush(Color.Red);
    e.Graphics.FillRegion(myBrush, myRegion);
}

Public Sub TransformExample(ByVal e As PaintEventArgs)

    ' Create the first rectangle and draw it to the screen in blue.
    Dim regionRect As New Rectangle(100, 50, 100, 100)
    e.Graphics.DrawRectangle(Pens.Blue, regionRect)

    ' Create a region using the first rectangle.
    Dim myRegion As New [Region](regionRect)

    ' Create a transform matrix and set it to have a 45 degree
    ' rotation.
    Dim transformMatrix As New Matrix
    transformMatrix.RotateAt(45, New PointF(100, 50))

    ' Apply the transform to the region.
    myRegion.Transform(transformMatrix)

    ' Fill the transformed region with red and draw it to the
    ' screen in red.
    Dim myBrush As New SolidBrush(Color.Red)
    e.Graphics.FillRegion(myBrush, myRegion)
End Sub