Método GraphicsPath::GetPathData (gdipluspath.h)

Artigo
08/24/2023

O método GraphicsPath::GetPathData obtém uma matriz de pontos e uma matriz de tipos de ponto desse caminho. Juntas, essas duas matrizes definem as linhas, as curvas, as figuras e os marcadores desse caminho.

Sintaxe

Status GetPathData(
  [out] PathData *pathData
);

Parâmetros

[out] pathData

Tipo: PathData*

Ponteiro para um objeto PathData que recebe os dados do caminho. O membro de dados Points do objeto PathData recebe um ponteiro para uma matriz de objetos PointF que contém os pontos de caminho. O membro de dados Types do objeto PathData recebe um ponteiro para uma matriz de bytes que contém os tipos de ponto. O membro de dados Count do objeto PathData recebe um inteiro que indica o número de elementos na matriz Points .

Retornar valor

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

Um objeto GraphicsPath tem uma matriz de pontos e uma matriz de tipos. Cada elemento na matriz de tipos é um byte que especifica o tipo de ponto e um conjunto de sinalizadores para o elemento correspondente na matriz de pontos. Possíveis tipos de ponto e sinalizadores são listados na enumeração PathPointType .

Você não precisa alocar ou desalocar memória para a matriz de pontos ou a matriz de tipos. O método GraphicsPath::GetPathData aloca memória para as matrizes (pontos e tipos) que retorna. O destruidor PathData desaloca a memória dessas matrizes.

Exemplos

O exemplo a seguir cria e desenha um caminho que tem uma linha, um retângulo, uma elipse e uma curva. O código obtém os pontos e tipos do caminho passando o endereço de um objeto PathData para o método GraphicsPath::GetPathData . Em seguida, o código desenha cada um dos pontos de dados do caminho.

VOID GetPathDataExample(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a path that has a line, a rectangle, an ellipse, and a curve.
   GraphicsPath path;
   
   PointF points[] = {
      PointF(200, 200),
      PointF(250, 240),
      PointF(200, 300),
      PointF(300, 310),
      PointF(250, 350)};

   path.AddLine(20, 100, 150, 200);
   path.AddRectangle(Rect(40, 30, 80, 60));
   path.AddEllipse(Rect(200, 30, 200, 100));
   path.AddCurve(points, 5);

   // Draw the path.
   Pen pen(Color(255, 0, 0, 255));
   graphics.DrawPath(&pen, &path);

   // Get the path data.
   PathData pathData;
   path.GetPathData(&pathData);

   // Draw the path's data points.
   SolidBrush brush(Color(255, 255, 0, 0));
   for(INT j = 0; j < pathData.Count; ++j)
   {
      graphics.FillEllipse(
         &brush, 
         pathData.Points[j].X - 3.0f, 
         pathData.Points[j].Y - 3.0f,
         6.0f,
         6.0f);
   }
}

Requisitos

Requisito	Valor
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	gdipluspath.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll