GraphicsPath-Klasse
Stellt eine Reihe verbundener Linien und Kurven dar. Diese Klasse kann nicht geerbt werden.
Namespace: System.Drawing.Drawing2D
Assembly: System.Drawing (in system.drawing.dll)
Syntax
'Declaration
Public NotInheritable Class GraphicsPath
Inherits MarshalByRefObject
Implements ICloneable, IDisposable
'Usage
Dim instance As GraphicsPath
public sealed class GraphicsPath : MarshalByRefObject, ICloneable, IDisposable
public ref class GraphicsPath sealed : public MarshalByRefObject, ICloneable, IDisposable
public final class GraphicsPath extends MarshalByRefObject implements ICloneable, IDisposable
public final class GraphicsPath extends MarshalByRefObject implements ICloneable, IDisposable
Hinweise
Pfade werden in Anwendungen verwendet, um Umrisse von Formen zu zeichnen, das Innere von Formen zu füllen und Ausschneidebereiche zu erstellen. Die Grafikengine verwaltet die Koordinaten geometrischer Formen in einem Pfad im Bereich globaler Koordinaten.
Ein Pfad kann aus einer beliebigen Anzahl von Figuren zusammengesetzt sein (untergeordnete Pfade). Jede Figur besteht entweder aus einer Abfolge verbundener Linien und Kurven oder aus einer geometrischen Grundform. Der Anfangspunkt einer Figur ist der erste Punkt in der Abfolge verbundener Linien und Kurven. Der Endpunkt ist der letzte Punkt in dieser Abfolge. Anfangs- und Endpunkte einer geometrischen Grundform werden durch deren Spezifikation definiert.
Eine Figur, die aus einer Abfolge verbundener Linien und Kurven besteht (deren Anfangs- und Endpunkt miteinander übereinstimmen können), ist eine offene Figur, wenn sie nicht explizit geschlossen wird. Eine Figur kann mithilfe der CloseFigure-Methode explizit geschlossen werden. Diese Methode schließt die aktuelle Figur, indem End- und Anfangspunkt durch eine Linie verbunden werden. Eine Figur, die aus einer geometrischen Grundform besteht, ist eine geschlossene Figur.
Um Figuren ausfüllen und ausschneiden zu können (wenn z. B. ein Pfad mithilfe von FillPath dargestellt wird), werden alle offenen Figuren geschlossen, indem eine vom Anfangs- zum Endpunkt der jeweiligen Figur verlaufende Linie hinzugefügt wird.
Eine neue Figur wird implizit begonnen, wenn ein Pfad erstellt oder eine Figur geschlossen wird. Eine neue Figur wird explizit begonnen, wenn die StartFigure-Methode aufgerufen wird.
Beim Hinzufügen einer geometrischen Grundform zu einem Pfad wird diesem eine Figur mit der geometrischen Form hinzugefügt und außerdem implizit eine neue Figur begonnen. Daher befindet sich in einem Pfad immer eine aktuelle Figur. Wenn Linien und Kurven einem Pfad hinzugefügt werden, wird eine implizite Linie hinzugefügt. Diese verbindet den Endpunkt der aktuellen Figur mit dem Anfangspunkt der neuen Linien und Kurven, damit sich eine Abfolge verbundener Linien und Kurven ergibt.
Eine Figur hat eine Richtung, die beschreibt, wie Linien- und Kurvensegmente zwischen dem Anfangs- und dem Endpunkt bezeichnet werden. Die Richtung wird durch die geometrische Grundform definiert oder durch die Reihenfolge, in der Linien und Kurven einer Figur hinzugefügt werden. Mithilfe der Richtung wird das Pfadinnere zum Ausschneiden und Füllen bestimmt.
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.Drawing.Drawing2D.GraphicsPath
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
GraphicsPath-Member
System.Drawing.Drawing2D-Namespace