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

Artigo
03/05/2024

O método GraphicsPath::AddPath adiciona um caminho a esse caminho.

Sintaxe

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

Parâmetros

[in] addingPath

Tipo: const GraphicsPath*

Ponteiro para o caminho a ser adicionado.

[in] connect

Tipo: BOOL

Valor BOOL que especifica se a primeira figura no caminho adicionado faz parte da última figura nesse caminho.

TRUE

Especifica que (se possível) a primeira figura no caminho adicionado faz parte da última figura nesse caminho.

FALSE

Especifica que a primeira figura no caminho adicionado é separada da última figura nesse caminho.

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Mesmo que o valor do parâmetro connect seja TRUE, esse método pode não ser capaz de fazer a primeira figura da parte do caminho adicionado da última figura desse caminho. Se qualquer uma dessas figuras for fechada, então elas devem permanecer figuras separadas.

Exemplos

O exemplo a seguir cria dois objetos GraphicsPath : path1 e path2. O código adiciona uma figura aberta que consiste em um arco e um spline de Bézier a cada caminho. O código chama o método GraphicsPath::AddPath de path1 para adicionar path2 a path1. O segundo argumento é TRUE, que especifica que todos os quatro itens (dois arcos e dois splines Bézier) pertencem à mesma 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	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdipluspath.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll