Metodo GraphicsPath::AddPath (gdipluspath.h)

Articolo
02/26/2024

Il metodo GraphicsPath::AddPath aggiunge un percorso a questo percorso.

Sintassi

Status AddPath(
  [in] const GraphicsPath *addingPath,
  [in] BOOL               connect
);

Parametri

[in] addingPath

Tipo: const GraphicsPath*

Puntatore al percorso da aggiungere.

[in] connect

Tipo: BOOL

Valore BOOL che specifica se la prima figura nel percorso aggiunto fa parte dell'ultima figura in questo percorso.

true

Specifica che, se possibile, la prima figura nel percorso aggiunto fa parte dell'ultima figura in questo percorso.

FALSE

Specifica che la prima figura nel percorso aggiunto è separata dall'ultima figura in questo percorso.

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 .

Commenti

Anche se il valore del parametro connect è TRUE, questo metodo potrebbe non essere in grado di creare la prima figura del percorso aggiunto nell'ultima figura di questo percorso. Se una di queste cifre è chiusa, devono rimanere cifre separate.

Esempio

Nell'esempio seguente vengono creati due oggetti GraphicsPath : path1 e path2. Il codice aggiunge una figura aperta costituita da un arco e da una spline di Bézier a ogni percorso. Il codice chiama il metodo GraphicsPath::AddPath di path1 per aggiungere path2 a path1. Il secondo argomento è TRUE, che specifica che tutti e quattro gli elementi (due archi e due spline di Bézier) appartengono alla stessa figura.

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

   GraphicsPath path1;
   path1.AddArc(10, 10, 50, 20, 0.0f, 150.0f);
   path1.AddBezier(10, 50, 60, 50, 10, 80, 60, 80);
   
   GraphicsPath path2;
   path2.AddArc(10, 110, 50, 20, 0.0f, 150.0f);
   path2.AddBezier(10, 150, 60, 150, 10, 180, 60, 180);
 
   path1.AddPath(&path2, TRUE);

   Pen pen(Color(255, 0, 0, 255));
   graphics.DrawPath(&pen, &path1);
}

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