Metodo GraphicsPath::Outline (gdipluspath.h)

Articolo
03/14/2023

Il metodo GraphicsPath::Outline trasforma e rende flat questo percorso e quindi converte i punti dati di questo percorso in modo che rappresentino solo la struttura del percorso.

Sintassi

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

Parametri

[in] matrix

Tipo: matrice const *

Facoltativa. Puntatore a un oggetto Matrix che specifica la trasformazione. Se questo parametro è NULL, non viene applicata alcuna trasformazione. Il valore predefinito è NULL.

[in] flatness

Tipo: REAL

Facoltativa. Numero reale che specifica l'errore massimo tra il percorso e l'approssimazione flat. La riduzione dell'appiattimento aumenta il numero di segmenti di linea nell'approssimazione. Il valore predefinito è FlatnessDefault, che è una costante definita in Gdiplusenums.h.

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

Un oggetto GraphicsPath archivia una raccolta di punti dati che rappresentano linee e curve. Il metodo GraphicsPath::Outline modifica tali punti dati e i punti dati originali vengono persi.

Esempio

Nell'esempio seguente viene creato un oggetto GraphicsPath e viene chiamato il metodo GraphicsPath::AddClosedCurve per aggiungere una spline cardinala chiusa al percorso. Il codice chiama il metodo GraphicsPath::Widen per ampliare il percorso e quindi disegnare il percorso. Successivamente, il codice chiama il metodo Outline del percorso. Il codice chiama il metodo TranslateTransform di un oggetto Graphics in modo che il percorso descritto disegnato dalla chiamata successiva a DrawPath si trova a destra del primo percorso.


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

Requisiti


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