GraphicsPath::Outline-Methode (gdipluspath.h)
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 |