GraphicsPath ::AddPath, méthode (gdipluspath.h)

Article
02/26/2024

La méthode GraphicsPath ::AddPath ajoute un chemin à ce chemin.

Syntaxe

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

Paramètres

[in] addingPath

Type : const GraphicsPath*

Pointeur vers le chemin à ajouter.

[in] connect

Type : BOOL

Valeur BOOL qui spécifie si la première figure du chemin ajouté fait partie de la dernière figure de ce chemin.

TRUE

Spécifie que (si possible) la première figure du chemin d’accès ajouté fait partie de la dernière figure de ce chemin.

FALSE

Spécifie que la première figure du chemin d’accès ajouté est distincte de la dernière figure de ce chemin.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

Même si la valeur du paramètre de connexion est TRUE, cette méthode peut ne pas être en mesure d’effectuer la première figure du chemin d’accès ajouté à la dernière figure de ce chemin. Si l’une ou l’autre de ces figures est fermée, elles doivent rester des figures distinctes.

Exemples

L’exemple suivant crée deux objets GraphicsPath : path1 et path2. Le code ajoute une figure ouverte composée d’un arc et d’une spline Bézier à chaque chemin. Le code appelle la méthode GraphicsPath ::AddPath de path1 pour ajouter path2 à path1. Le deuxième argument est TRUE, qui spécifie que les quatre éléments (deux arcs et deux lignes de Bézier) appartiennent à la même figure.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdipluspath.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll