Ler em inglês

Partilhar via


Graphics.TransformPoints Método

Definição

Transforma uma matriz de pontos de um espaço de coordenadas para outro usando o mundo atual e as transformações de página desta Graphics.

Sobrecargas

TransformPoints(CoordinateSpace, CoordinateSpace, Point[])

Transforma uma matriz de pontos de um espaço de coordenadas para outro usando o mundo atual e as transformações de página desta Graphics.

TransformPoints(CoordinateSpace, CoordinateSpace, PointF[])

Transforma uma matriz de pontos de um espaço de coordenadas para outro usando o mundo atual e as transformações de página desta Graphics.

TransformPoints(CoordinateSpace, CoordinateSpace, ReadOnlySpan<Point>)
TransformPoints(CoordinateSpace, CoordinateSpace, ReadOnlySpan<PointF>)

TransformPoints(CoordinateSpace, CoordinateSpace, Point[])

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Transforma uma matriz de pontos de um espaço de coordenadas para outro usando o mundo atual e as transformações de página desta Graphics.

C#
public void TransformPoints (System.Drawing.Drawing2D.CoordinateSpace destSpace, System.Drawing.Drawing2D.CoordinateSpace srcSpace, System.Drawing.Point[] pts);
C#
public void TransformPoints (System.Drawing.Drawing2D.CoordinateSpace destSpace, System.Drawing.Drawing2D.CoordinateSpace srcSpace, params System.Drawing.Point[] pts);

Parâmetros

destSpace
CoordinateSpace

Membro da enumeração CoordinateSpace que especifica o espaço de coordenadas de destino.

srcSpace
CoordinateSpace

Membro da enumeração CoordinateSpace que especifica o espaço de coordenadas de origem.

pts
Point[]

Matriz de estruturas de Point que representa os pontos para a transformação.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

  • Cria dois pontos e desenha uma linha azul entre eles.

  • Define a transformação do mundo a ser traduzida pelos valores 40 na direção x e 30 na direção y.

  • Transforma os pontos de coordenadas mundiais (World) em coordenadas de página (Page).

  • Redefine a transformação do mundo para a identidade.

  • Desenha uma linha vermelha entre os pontos transformados.

O resultado é uma linha azul e uma linha vermelha traduzida abaixo dela.

C#
private void TransformPointsPoint(PaintEventArgs e)
{

    // Create array of two points.
    Point[] points = { new Point(0, 0), new Point(100, 50) };

    // Draw line connecting two untransformed points.
    e.Graphics.DrawLine(new Pen(Color.Blue, 3), points[0], points[1]);

    // Set world transformation of Graphics object to translate.
    e.Graphics.TranslateTransform(40, 30);

    // Transform points in array from world to page coordinates.
    e.Graphics.TransformPoints(CoordinateSpace.Page, CoordinateSpace.World, points);

    // Reset world transformation.
    e.Graphics.ResetTransform();

    // Draw line that connects transformed points.
    e.Graphics.DrawLine(new Pen(Color.Red, 3), points[0], points[1]);
}

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

TransformPoints(CoordinateSpace, CoordinateSpace, PointF[])

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Transforma uma matriz de pontos de um espaço de coordenadas para outro usando o mundo atual e as transformações de página desta Graphics.

C#
public void TransformPoints (System.Drawing.Drawing2D.CoordinateSpace destSpace, System.Drawing.Drawing2D.CoordinateSpace srcSpace, System.Drawing.PointF[] pts);
C#
public void TransformPoints (System.Drawing.Drawing2D.CoordinateSpace destSpace, System.Drawing.Drawing2D.CoordinateSpace srcSpace, params System.Drawing.PointF[] pts);

Parâmetros

destSpace
CoordinateSpace

Membro da enumeração CoordinateSpace que especifica o espaço de coordenadas de destino.

srcSpace
CoordinateSpace

Membro da enumeração CoordinateSpace que especifica o espaço de coordenadas de origem.

pts
PointF[]

Matriz de estruturas PointF que representam os pontos a serem transformados.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

  • Cria dois pontos e desenha uma linha azul entre eles.

  • Define a transformação do mundo a ser traduzida pelos valores 40 na direção x e 30 na direção y.

  • Transforma os pontos de coordenadas mundiais (World) em coordenadas de página (Page).

  • Redefine a transformação do mundo para a identidade e desenha uma linha vermelha entre os pontos transformados.

O resultado é uma linha azul e uma linha vermelha traduzida abaixo dela.

C#
private void TransformPointsPointF(PaintEventArgs e)
{

    // Create array of two points.
    PointF[] points = { new PointF(0.0F, 0.0F), new PointF(100.0F, 50.0F) };

    // Draw line connecting two untransformed points.
    e.Graphics.DrawLine(new Pen(Color.Blue, 3), points[0], points[1]);

    // Set world transformation of Graphics object to translate.
    e.Graphics.TranslateTransform(40.0F, 30.0F);

    // Transform points in array from world to page coordinates.
    e.Graphics.TransformPoints(CoordinateSpace.Page, CoordinateSpace.World, points);

    // Reset world transformation.
    e.Graphics.ResetTransform();

    // Draw line that connects transformed points.
    e.Graphics.DrawLine(new Pen(Color.Red, 3), points[0], points[1]);
}

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

TransformPoints(CoordinateSpace, CoordinateSpace, ReadOnlySpan<Point>)

Origem:
Graphics.cs
C#
public void TransformPoints (System.Drawing.Drawing2D.CoordinateSpace destSpace, System.Drawing.Drawing2D.CoordinateSpace srcSpace, scoped ReadOnlySpan<System.Drawing.Point> pts);

Parâmetros

destSpace
CoordinateSpace
srcSpace
CoordinateSpace

Aplica-se a

.NET 9 e Windows Desktop 9
Produto Versões
.NET 9
Windows Desktop 9

TransformPoints(CoordinateSpace, CoordinateSpace, ReadOnlySpan<PointF>)

Origem:
Graphics.cs
C#
public void TransformPoints (System.Drawing.Drawing2D.CoordinateSpace destSpace, System.Drawing.Drawing2D.CoordinateSpace srcSpace, scoped ReadOnlySpan<System.Drawing.PointF> pts);

Parâmetros

destSpace
CoordinateSpace
srcSpace
CoordinateSpace

Aplica-se a

.NET 9 e Windows Desktop 9
Produto Versões
.NET 9
Windows Desktop 9