Metodo GraphicsPath::GetPathData (gdipluspath.h)

Articolo
08/24/2023

Il metodo GraphicsPath::GetPathData ottiene una matrice di punti e una matrice di tipi di punti da questo percorso. Insieme, queste due matrici definiscono le linee, le curve, le figure e gli indicatori di questo percorso.

Sintassi

Status GetPathData(
  [out] PathData *pathData
);

Parametri

[out] pathData

Tipo: PathData*

Puntatore a un oggetto PathData che riceve i dati del percorso. Il membro dati Points dell'oggetto PathData riceve un puntatore a una matrice di oggetti PointF che contiene i punti del percorso. Il membro dati Type dell'oggetto PathData riceve un puntatore a una matrice di byte che contiene i tipi di punto. Il membro dei dati Count dell'oggetto PathData riceve un numero intero che indica il numero di elementi nella matrice Punti .

Valore restituito

Tipo: Stato

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

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

Commenti

Un oggetto GraphicsPath include una matrice di punti e 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 tipi di punti e i flag possibili sono elencati nell'enumerazione PathPointType .

Non è necessario allocare o deallocare la memoria per la matrice di punti o la matrice di tipi. Il metodo GraphicsPath::GetPathData alloca la memoria per le matrici (punti e tipi) restituite. Il distruttore PathData dealloca la memoria per tali matrici.

Esempio

Nell'esempio seguente viene creato e disegnato un percorso con una linea, un rettangolo, un ellisse e una curva. Il codice ottiene i punti e i tipi del percorso passando l'indirizzo di un oggetto PathData al metodo GraphicsPath::GetPathData . Il codice disegna quindi ognuno dei punti dati del percorso.

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);
   }
}

Requisiti

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	Windows
Intestazione	gdipluspath.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll