Método GraphicsPath::AddPath (gdipluspath.h)

Artículo
02/29/2024

El método GraphicsPath::AddPath agrega una ruta de acceso a esta ruta de acceso.

Sintaxis

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

Parámetros

[in] addingPath

Tipo: const GraphicsPath*

Puntero a la ruta de acceso que se va a agregar.

[in] connect

Tipo: BOOL

Valor BOOL que especifica si la primera figura de la ruta de acceso agregada forma parte de la última figura de esta ruta de acceso.

TRUE

Especifica que (si es posible) la primera figura de la ruta de acceso agregada forma parte de la última figura de esta ruta de acceso.

FALSE

Especifica que la primera figura de la ruta de acceso agregada es independiente de la última figura de esta ruta de acceso.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Incluso si el valor del parámetro connect es TRUE, es posible que este método no pueda crear la primera figura de la parte de ruta de acceso agregada de la última figura de esta ruta de acceso. Si alguna de esas cifras está cerrada, debe permanecer separadas.

Ejemplos

En el ejemplo siguiente se crean dos objetos GraphicsPath : path1 y path2. El código agrega una figura abierta que consta de un arco y una spline bézier a cada ruta de acceso. El código llama al método GraphicsPath::AddPath de path1 para agregar path2 a path1. El segundo argumento es TRUE, que especifica que los cuatro elementos (dos arcos y dos splines bézier) pertenecen a la misma 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);
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdipluspath.h (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll