GraphicsPath::Outline-Methode (gdipluspath.h)

Artikel
08/24/2023

Die GraphicsPath::Outline-Methode transformiert und vereinfacht diesen Pfad und konvertiert dann die Datenpunkte dieses Pfads, sodass sie nur die Gliederung des Pfads darstellen.

Syntax

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

Parameter

[in] matrix

Typ: const Matrix*

Optional. Zeiger auf ein Matrix-Objekt , das die Transformation angibt. Wenn dieser Parameter NULL ist, wird keine Transformation angewendet. Der Standardwert ist NULL.

[in] flatness

Typ: REAL

Optional. Reelle Zahl, die den maximalen Fehler zwischen dem Pfad und seiner vereinfachten Näherung angibt. Durch verringern der Flachheit erhöht sich die Anzahl der Liniensegmente in der Näherung. Der Standardwert ist FlatnessDefault, eine konstante, die in Gdiplusenums.h definiert ist.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Ein GraphicsPath-Objekt speichert eine Auflistung von Datenpunkten, die Linien und Kurven darstellen. Die GraphicsPath::Outline-Methode ändert diese Datenpunkte, und die ursprünglichen Datenpunkte gehen verloren.

Beispiele

Im folgenden Beispiel wird ein GraphicsPath-Objekt erstellt und die GraphicsPath::AddClosedCurve-Methode aufgerufen, um dem Pfad eine geschlossene Kardinalspline hinzuzufügen. Der Code ruft die GraphicsPath::Widen-Methode auf, um den Pfad zu erweitern, und zeichnet dann den Pfad. Als Nächstes ruft der Code die Outline-Methode des Pfads auf. Der Code ruft die TranslateTransform-Methode eines Graphics-Objekts auf, sodass sich der vom nachfolgenden Aufruf von DrawPath gezeichnete umrissene Pfad rechts neben dem ersten Pfad befindet.


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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdipluspath.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll