Pen.MultiplyTransform Methode

Definition

Multipliziert die Transformationsmatrix dafür Pen durch die angegebene Matrix.

Überlädt

Name Beschreibung
MultiplyTransform(Matrix)

Multipliziert die Transformationsmatrix dafür Pen durch die angegebene Matrix.

MultiplyTransform(Matrix, MatrixOrder)

Multipliziert die Transformationsmatrix dafür Pen mit der in der angegebenen Reihenfolge angegebenen Matrix Reihenfolge.

MultiplyTransform(Matrix)

Multipliziert die Transformationsmatrix dafür Pen durch die angegebene Matrix.

public:
 void MultiplyTransform(System::Drawing::Drawing2D::Matrix ^ matrix);
public void MultiplyTransform(System.Drawing.Drawing2D.Matrix matrix);
member this.MultiplyTransform : System.Drawing.Drawing2D.Matrix -> unit
Public Sub MultiplyTransform (matrix As Matrix)

Parameter

matrix
Matrix

Das Matrix Objekt, mit dem die Transformationsmatrix multipliziert werden soll.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des ereignishandlers Paint handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine Pen.

  • Zeichnet eine Linie auf dem Bildschirm.

  • Multipliziert die Transformationsmatrix des Stifts mit der angegebenen Matrix.

  • Zeichnet eine Linie mit dem transformierten Stift.

public:
   void MultiplyTransform_Example1( PaintEventArgs^ e )
   {
      
      // Create a Pen object.
      Pen^ myPen = gcnew Pen( Color::Black,5.0f );
      
      // Create a translation matrix.
      Matrix^ penMatrix = gcnew Matrix;
      penMatrix->Scale( 3, 1 );
      
      // Multiply the transformation matrix of myPen by transMatrix.
      myPen->MultiplyTransform( penMatrix );
      
      // Draw a line to the screen.
      e->Graphics->DrawLine( myPen, 0, 0, 100, 100 );
   }
public void MultiplyTransform_Example1(PaintEventArgs e)
{
             
    // Create a Pen object.
    Pen myPen = new Pen(Color.Black, 5);
             
    // Create a translation matrix.
    Matrix penMatrix = new Matrix();
    penMatrix.Scale(3, 1);
             
    // Multiply the transformation matrix of myPen by transMatrix.
    myPen.MultiplyTransform(penMatrix);
             
    // Draw a line to the screen.
    e.Graphics.DrawLine(myPen, 0, 0, 100, 100);
}
Public Sub MultiplyTransform_Example1(ByVal e As PaintEventArgs)

    ' Create a Pen object.
    Dim myPen As New Pen(Color.Black, 5)

    ' Create a translation matrix.
    Dim penMatrix As New Matrix
    penMatrix.Scale(3, 1)

    ' Multiply the transformation matrix of myPen by transMatrix.
    myPen.MultiplyTransform(penMatrix)

    ' Draw a line to the screen.
    e.Graphics.DrawLine(myPen, 0, 0, 100, 100)
End Sub

Hinweise

Diese Methode stellt die im matrix Parameter angegebene Multiplikationsmatrix der Transformationsmatrix für den Multiplikationsvorgang voran.

Gilt für:

MultiplyTransform(Matrix, MatrixOrder)

Multipliziert die Transformationsmatrix dafür Pen mit der in der angegebenen Reihenfolge angegebenen Matrix Reihenfolge.

public:
 void MultiplyTransform(System::Drawing::Drawing2D::Matrix ^ matrix, System::Drawing::Drawing2D::MatrixOrder order);
public void MultiplyTransform(System.Drawing.Drawing2D.Matrix matrix, System.Drawing.Drawing2D.MatrixOrder order);
member this.MultiplyTransform : System.Drawing.Drawing2D.Matrix * System.Drawing.Drawing2D.MatrixOrder -> unit
Public Sub MultiplyTransform (matrix As Matrix, order As MatrixOrder)

Parameter

matrix
Matrix

Die Matrix , mit der die Transformationsmatrix multipliziert werden soll.

order
MatrixOrder

Die Reihenfolge, in der der Multiplikationsvorgang ausgeführt werden soll.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des ereignishandlers Paint handelt. Der Code führt die folgenden Aktionen aus:

  • Erstellt eine Pen.

  • Zeichnet eine Linie auf dem Bildschirm.

  • Multipliziert die Transformationsmatrix des Stifts mit der angegebenen Matrix.

  • Zeichnet eine Linie mit dem transformierten Stift.

public:
   void MultiplyTransform_Example2( PaintEventArgs^ e )
   {
      
      // Create a Pen object.
      Pen^ myPen = gcnew Pen( Color::Black,5.0f );
      
      // Create a translation matrix.
      Matrix^ penMatrix = gcnew Matrix;
      penMatrix->Scale( 3, 1 );
      
      // Multiply the transformation matrix of myPen by transMatrix.
      myPen->MultiplyTransform( penMatrix, MatrixOrder::Prepend );
      
      // Draw a line to the screen.
      e->Graphics->DrawLine( myPen, 0, 0, 100, 100 );
   }
public void MultiplyTransform_Example2(PaintEventArgs e)
{
             
    // Create a Pen object.
    Pen myPen = new Pen(Color.Black, 5);
             
    // Create a translation matrix.
    Matrix penMatrix = new Matrix();
    penMatrix.Scale(3, 1);
             
    // Multiply the transformation matrix of myPen by transMatrix.
    myPen.MultiplyTransform(penMatrix, MatrixOrder.Prepend);
             
    // Draw a line to the screen.
    e.Graphics.DrawLine(myPen, 0, 0, 100, 100);
}
Public Sub MultiplyTransform_Example2(ByVal e As PaintEventArgs)

    ' Create a Pen object.
    Dim myPen As New Pen(Color.Black, 5)

    ' Create a translation matrix.
    Dim penMatrix As New Matrix
    penMatrix.Scale(3, 1)

    ' Multiply the transformation matrix of myPen by transMatrix.
    myPen.MultiplyTransform(penMatrix, MatrixOrder.Prepend)

    ' Draw a line to the screen.
    e.Graphics.DrawLine(myPen, 0, 0, 100, 100)
End Sub

Hinweise

Diese Methode verwendet das MatrixOrder Enumerationselement (entweder vor oder anfügen), das order vom Parameter angegeben wird, um den Multiplikationsvorgang auszuführen.

Gilt für: