Matrix.TransformVectors 方法  
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将数组中的每个向量乘以矩阵。 忽略此矩阵(第三行)的转换元素。
重载
| TransformVectors(Point[]) | 仅将此 Matrix 的刻度和旋转组件应用于指定的点数组。 | 
| TransformVectors(PointF[]) | 将数组中的每个向量乘以矩阵。 忽略此矩阵(第三行)的转换元素。 | 
| TransformVectors(ReadOnlySpan<Point>) | |
| TransformVectors(ReadOnlySpan<PointF>) | 
TransformVectors(Point[])
- Source:
- Matrix.cs
- Source:
- Matrix.cs
- Source:
- Matrix.cs
- Source:
- Matrix.cs
- Source:
- Matrix.cs
仅将此 Matrix 的刻度和旋转组件应用于指定的点数组。
public:
 void TransformVectors(cli::array <System::Drawing::Point> ^ pts);public:
 void TransformVectors(... cli::array <System::Drawing::Point> ^ pts);public void TransformVectors (System.Drawing.Point[] pts);public void TransformVectors (params System.Drawing.Point[] pts);member this.TransformVectors : System.Drawing.Point[] -> unitPublic Sub TransformVectors (pts As Point())Public Sub TransformVectors (ParamArray pts As Point())参数
示例
下面的代码示例旨在与 Windows 窗体一起使用,它需要 PaintEventArgsePaint 事件对象。 该代码执行以下操作:
- 创建构成矩形的点数组。 
- 在应用缩放转换(蓝色矩形)之前,将此点数组绘制到屏幕。 
- 创建矩阵并将其缩放为 x 轴中的 3,在 y 轴中为 2,并在两个轴中将其平移 100。 
- 列出屏幕中的矩阵元素。 
- 将此矩阵转换应用于点数组。 
- 将转换后的数组绘制到屏幕(红色矩形)。 
请注意,红色矩形已按 x 轴中的 3 因子缩放,在 y 轴中缩放 2,包括矩形左上角(矩形的起点),但忽略转换向量(矩阵的最后两个元素)。
public:
   void TransformVectorsExample( PaintEventArgs^ e )
   {
      Pen^ myPen = gcnew Pen( Color::Blue,1.0f );
      Pen^ myPen2 = gcnew Pen( Color::Red,1.0f );
      // Create an array of points.
      array<Point>^ myArray = {Point(20,20),Point(120,20),Point(120,120),Point(20,120),Point(20,20)};
      // Draw the Points to the screen before applying the
      // transform.
      e->Graphics->DrawLines( myPen, myArray );
      // Create a matrix, scale it, and translate it.
      Matrix^ myMatrix = gcnew Matrix;
      myMatrix->Scale( 3, 2, MatrixOrder::Append );
      myMatrix->Translate( 100, 100, MatrixOrder::Append );
      // List the matrix elements to the screen.
      ListMatrixElements( e, myMatrix, "Scaled and Translated Matrix", 6, 20 );
      // Apply the transform to the array.
      myMatrix->TransformVectors( myArray );
      // Draw the Points to the screen again after applying the
      // transform.
      e->Graphics->DrawLines( myPen2, myArray );
   }
   //-------------------------------------------------------
   // This function is a helper function to
   // list the contents of a matrix.
   //-------------------------------------------------------
   void ListMatrixElements( PaintEventArgs^ e, Matrix^ matrix, String^ matrixName, int numElements, int y )
   {
      // Set up variables for drawing the array
      // of points to the screen.
      int i;
      float x = 20,X = 200;
      System::Drawing::Font^ myFont = gcnew System::Drawing::Font( "Arial",8 );
      SolidBrush^ myBrush = gcnew SolidBrush( Color::Black );
      // Draw the matrix name to the screen.
      e->Graphics->DrawString( String::Concat( matrixName, ":  " ), myFont, myBrush, (float)x, (float)y );
      // Draw the set of path points and types to the screen.
      for ( i = 0; i < numElements; i++ )
      {
         e->Graphics->DrawString( String::Concat( matrix->Elements[ i ], ", " ), myFont, myBrush, (float)X, (float)y );
         X += 30;
      }
   }
public void TransformVectorsExample(PaintEventArgs e)
{
    Pen myPen = new Pen(Color.Blue, 1);
    Pen myPen2 = new Pen(Color.Red, 1);
             
    // Create an array of points.
    Point[] myArray =
             {
                 new Point(20, 20),
                 new Point(120, 20),
                 new Point(120, 120),
                 new Point(20, 120),
                 new Point(20,20)
             };
             
    // Draw the Points to the screen before applying the
    // transform.
    e.Graphics.DrawLines(myPen, myArray);
             
    // Create a matrix, scale it, and translate it.
    Matrix myMatrix = new Matrix();
    myMatrix.Scale(3, 2, MatrixOrder.Append);
    myMatrix.Translate(100, 100, MatrixOrder.Append);
             
    // List the matrix elements to the screen.
    ListMatrixElements(e,
        myMatrix,
        "Scaled and Translated Matrix",
        6,
        20);
             
    // Apply the transform to the array.
    myMatrix.TransformVectors(myArray);
             
    // Draw the Points to the screen again after applying the
    // transform.
    e.Graphics.DrawLines(myPen2, myArray);
}
             
//-------------------------------------------------------
// This function is a helper function to
// list the contents of a matrix.
//-------------------------------------------------------
public void ListMatrixElements(
    PaintEventArgs e,
    Matrix matrix,
    string matrixName,
    int numElements,
    int y)
{
             
    // Set up variables for drawing the array
    // of points to the screen.
    int i;
    float x = 20, X = 200;
    Font myFont = new Font("Arial", 8);
    SolidBrush myBrush = new SolidBrush(Color.Black);
             
    // Draw the matrix name to the screen.
    e.Graphics.DrawString(
        matrixName + ":  ",
        myFont,
        myBrush,
        x,
        y);
             
    // Draw the set of path points and types to the screen.
    for(i=0; i<numElements; i++)
    {
        e.Graphics.DrawString(
            matrix.Elements[i].ToString() + ", ",
            myFont,
            myBrush,
            X,
            y);
        X += 30;
    }
}
Public Sub TransformVectorsExample(ByVal e As PaintEventArgs)
    Dim myPen As New Pen(Color.Blue, 1)
    Dim myPen2 As New Pen(Color.Red, 1)
    ' Create an array of points.
    Dim myArray As Point() = {New Point(20, 20), New Point(120, 20), _
    New Point(120, 120), New Point(20, 120), New Point(20, 20)}
    ' Draw the Points to the screen before applying the
    ' transform.
    e.Graphics.DrawLines(myPen, myArray)
    ' Create a matrix and scale it.
    Dim myMatrix As New Matrix
    myMatrix.Scale(3, 2, MatrixOrder.Append)
    myMatrix.Translate(100, 100, MatrixOrder.Append)
    ListMatrixElementsHelper(e, myMatrix, _
    "Scaled and Translated Matrix", 6, 20)
    myMatrix.TransformVectors(myArray)
    ' Draw the Points to the screen again after applying the
    ' transform.
    e.Graphics.DrawLines(myPen2, myArray)
End Sub
' A helper function to list the contents of a matrix.
Public Sub ListMatrixElementsHelper(ByVal e As PaintEventArgs, _
ByVal matrix As Matrix, ByVal matrixName As String, ByVal numElements As Integer, _
ByVal y As Integer)
    ' Set up variables for drawing the array
    ' of points to the screen.
    Dim i As Integer
    Dim x As Single = 20
    Dim j As Single = 200
    Dim myFont As New Font("Arial", 8)
    Dim myBrush As New SolidBrush(Color.Black)
    ' Draw the matrix name to the screen.
    e.Graphics.DrawString(matrixName + ":  ", myFont, myBrush, x, y)
    ' Draw the set of path points and types to the screen.
    For i = 0 To numElements - 1
        e.Graphics.DrawString(matrix.Elements(i).ToString() + ", ", _
        myFont, myBrush, j, y)
        j += 30
    Next i
End Sub
适用于
TransformVectors(PointF[])
- Source:
- Matrix.cs
- Source:
- Matrix.cs
- Source:
- Matrix.cs
- Source:
- Matrix.cs
- Source:
- Matrix.cs
将数组中的每个向量乘以矩阵。 忽略此矩阵(第三行)的转换元素。
public:
 void TransformVectors(cli::array <System::Drawing::PointF> ^ pts);public:
 void TransformVectors(... cli::array <System::Drawing::PointF> ^ pts);public void TransformVectors (System.Drawing.PointF[] pts);public void TransformVectors (params System.Drawing.PointF[] pts);member this.TransformVectors : System.Drawing.PointF[] -> unitPublic Sub TransformVectors (pts As PointF())Public Sub TransformVectors (ParamArray pts As PointF())参数
示例
有关示例,请参阅 TransformVectors(Point[])。
适用于
TransformVectors(ReadOnlySpan<Point>)
- Source:
- Matrix.cs
public:
 void TransformVectors(ReadOnlySpan<System::Drawing::Point> pts);public void TransformVectors (scoped ReadOnlySpan<System.Drawing.Point> pts);member this.TransformVectors : ReadOnlySpan<System.Drawing.Point> -> unitPublic Sub TransformVectors (pts As ReadOnlySpan(Of Point))参数
- pts
- ReadOnlySpan<Point>
适用于
TransformVectors(ReadOnlySpan<PointF>)
- Source:
- Matrix.cs
public:
 void TransformVectors(ReadOnlySpan<System::Drawing::PointF> pts);public void TransformVectors (scoped ReadOnlySpan<System.Drawing.PointF> pts);member this.TransformVectors : ReadOnlySpan<System.Drawing.PointF> -> unitPublic Sub TransformVectors (pts As ReadOnlySpan(Of PointF))参数
- pts
- ReadOnlySpan<PointF>