Compartilhar via


Método GraphicsPath::GetPathPoints(Point*,INT) (gdipluspath.h)

O método GraphicsPath::GetPathPoints obtém a matriz de pontos desse caminho. A matriz contém os pontos de extremidade e pontos de controle das linhas e splines de Bézier que são usados para desenhar o caminho.

Sintaxe

Status GetPathPoints(
  [out] Point *points,
  [in]  INT   count
);

Parâmetros

[out] points

Tipo: Point*

Ponteiro para uma matriz de Point objetos que recebem os pontos de dados. Você deve alocar memória para essa matriz. Você pode chamar o método GraphicsPath::GetPointCount para determinar o tamanho necessário da matriz. O tamanho, em bytes, deve ser o valor retornado de GraphicsPath::GetPointCount multiplicado por sizeof(Point).

[in] count

Tipo: INT

Inteiro que especifica o número de elementos nos pontos matriz. Defina esse parâmetro igual ao valor retornado do método GraphicsPath::GetPointCount.

Valor de retorno

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.

Observações

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. Os possíveis tipos de ponto e sinalizadores são listados na enumeração PathPointType.

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 chama o método GraphicsPath::GetPointCount do caminho para determinar o número de pontos de dados armazenados no caminho. O código aloca um buffer grande o suficiente para receber a matriz de pontos de dados e passa o endereço desse buffer para o método GraphicsPath::GetPathPoints. Por fim, o código desenha cada um dos pontos de dados do caminho.

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

   // Create a path that has a line, a rectangle, an ellipse, and a curve.
   GraphicsPath path;

   Point points[] = {
      Point(200, 200),
      Point(250, 240),
      Point(200, 300),
      Point(300, 310),
      Point(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 points.
   INT count = path.GetPointCount();
   Point* dataPoints = new Point[count];
   path.GetPathPoints(dataPoints, count);

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho gdipluspath.h (inclua Gdiplus.h)
biblioteca Gdiplus.lib
de DLL Gdiplus.dll

Consulte também

recorte de com um de região

de construção e desenho

criando um de gradiente de caminho

GraphicsPath

GraphicsPath::GetPathData

GraphicsPath::GetPathTypes

GraphicsPath::GetPointCount

PathData

PathPointType

caminhos

do ponto de