Metodo GraphicsPath::GetPathPoints(Point*,INT) (gdipluspath.h)

Articolo
08/15/2024

Il metodo GraphicsPath::GetPathPoints ottiene la matrice di punti di questo percorso. La matrice contiene gli endpoint e i punti di controllo delle linee e delle spline di Bézier utilizzati per disegnare il percorso.

Sintassi

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

Parametri

[out] points

Tipo: punto

Puntatore a una matrice di oggetti Point che riceve i punti dati. È necessario allocare memoria per questa matrice. È possibile chiamare il metodo GraphicsPath::GetPointCount per determinare le dimensioni necessarie della matrice. Le dimensioni, in byte, devono essere il valore restituito di GraphicsPath::GetPointCount moltiplicato per sizeof(Point).

[in] count

Tipo: INT

Integer che specifica il numero di elementi nella matrice punti. Impostare questo parametro uguale al valore restituito del metodo GraphicsPath::GetPointCount.

Valore restituito

Tipo: stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status.

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status.

Osservazioni

Un oggetto GraphicsPath dispone di una matrice di punti e di una matrice di tipi. Ogni elemento nella matrice di tipi è un byte che specifica il tipo di punto e un set di flag per l'elemento corrispondente nella matrice di punti. I possibili tipi di punti e flag sono elencati nell'enumerazione PathPointType .

Esempi

Nell'esempio seguente viene creato e disegnato un percorso con una linea, un rettangolo, un'ellisse e una curva. Il codice chiama il metodo GraphicsPath::GetPointCount del percorso per determinare il numero di punti dati archiviati nel percorso. Il codice alloca un buffer sufficientemente grande da ricevere la matrice di punti dati e passa l'indirizzo del buffer al metodo GraphicsPath::GetPathPoints. Infine, il codice disegna ognuno dei punti dati del percorso.

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)

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	gdipluspath.h (include Gdiplus.h)
libreria	Gdiplus.lib
dll	Gdiplus.dll