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

Artigo
08/24/2023

O método GraphicsPath::Outline transforma e nivela esse caminho e converte os pontos de dados desse caminho para que eles representem apenas a estrutura de tópicos do caminho.

Sintaxe

Status Outline(
  [in] const Matrix *matrix,
  [in] REAL         flatness
);

Parâmetros

[in] matrix

Tipo: const Matrix*

Opcional. Ponteiro para um objeto Matrix que especifica a transformação. Se esse parâmetro for NULL, nenhuma transformação será aplicada. O valor padrão é NULL.

[in] flatness

Tipo: REAL

Opcional. Número real que especifica o erro máximo entre o caminho e sua aproximação nivelada. Reduzir o a flatness aumenta o número de segmentos de linha na aproximação. O valor padrão é FlatnessDefault, que é uma constante definida em Gdiplusenums.h.

Valor retornado

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

Um objeto GraphicsPath armazena uma coleção de pontos de dados que representam linhas e curvas. O método GraphicsPath::Outline altera esses pontos de dados e os pontos de dados originais são perdidos.

Exemplos

O exemplo a seguir cria um objeto GraphicsPath e chama o método GraphicsPath::AddClosedCurve para adicionar um spline cardinal fechado ao caminho. O código chama o método GraphicsPath::Widen para ampliar o caminho e desenha o caminho. Em seguida, o código chama o método Outline do caminho. O código chama o método TranslateTransform de um objeto Graphics para que o caminho descrito pela chamada subsequente para DrawPath fique à direita do primeiro caminho.


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

   Pen bluePen(Color(255, 0, 0, 255));
   Pen greenPen(Color(255, 0, 255,  0), 10);

   PointF points[] = {
      PointF(20.0f, 20.0f),
      PointF(160.0f, 100.0f),
      PointF(140.0f, 60.0f),
      PointF(60.0f, 100.0f)};

   GraphicsPath path;
   path.AddClosedCurve(points, 4);

   path.Widen(&greenPen);
   graphics.DrawPath(&bluePen, &path);

   path.Outline();

   graphics.TranslateTransform(180.0f, 0.0f);
   graphics.DrawPath(&bluePen, &path);
}

Requisitos


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