Método Graphics::TransformPoints(CoordinateSpace,CoordinateSpace,PointF*,INT) (gdiplusgraphics.h)

Artigo
08/24/2023

O método Graphics::TransformPoints converte uma matriz de pontos de um espaço de coordenadas em outro. A conversão é baseada no mundo atual e nas transformações de página deste objeto Graphics .

Sintaxe

Status TransformPoints(
  [in]      CoordinateSpace destSpace,
  [in]      CoordinateSpace srcSpace,
  [in, out] PointF          *pts,
  [in]      INT             count
);

Parâmetros

[in] destSpace

Tipo: CoordinateSpace

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

[in] srcSpace

Tipo: CoordinateSpace

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

[in, out] pts

Tipo: Ponto*

Ponteiro para uma matriz que, na entrada, mantém os pontos a serem convertidos e, na saída, mantém os pontos convertidos.

[in] count

Tipo: INT

Inteiro que especifica o número de elementos na matriz pts .

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

A transformação de mundo converte pontos do espaço de coordenadas do mundo para o espaço de coordenadas da página. A transformação de página converte pontos do espaço de coordenadas da página para o espaço de coordenadas do dispositivo. Para obter mais informações sobre espaços de coordenadas, consulte Tipos de sistemas de coordenadas.

Exemplos

O exemplo a seguir cria um objeto Graphics e define sua transformação de mundo para uma tradução de 40 unidades à direita e 30 unidades para baixo. Em seguida, o código cria uma matriz de pontos e passa o endereço dessa matriz para o método Graphics::TransformPoints do mesmo objeto Graphics . Os pontos na matriz são transformados pela transformação mundial do objeto Graphics . O código chama o método Graphics::D rawLine duas vezes: uma para conectar os dois pontos antes da transformação e uma vez para conectar os dois pontos após a transformação.

VOID Example_TransformPoints(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 255));

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

   // Draw a line that connects the two points.
   // No transformation has been performed yet.
   graphics.DrawLine(&pen, points[0], points[1]);

   // Set the world transformation of the Graphics object.
   graphics.TranslateTransform(40.0f, 30.0f);

   // Transform the points in the array from world to page coordinates.
   graphics.TransformPoints(
      CoordinateSpacePage, 
      CoordinateSpaceWorld, 
      points, 
      2);

   // It is the world transformation that takes points from world
   // space to page space. Because the world transformation is a
   // translation 40 to the right and 30 down, the
   // points in the array are now (40, 30) and (140, 80).

   // Draw a line that connects the transformed points.
   graphics.ResetTransform();
   graphics.DrawLine(&pen, points[0], points[1]);
}

Requisitos


Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll