GraphicsPath Klasse

Definition

Stellt eine Reihe verbundener Linien und Kurven dar. Diese Klasse kann nicht vererbt werden.

public ref class GraphicsPath sealed : MarshalByRefObject, ICloneable, IDisposable
public sealed class GraphicsPath : MarshalByRefObject, ICloneable, IDisposable
type GraphicsPath = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
Public NotInheritable Class GraphicsPath
Inherits MarshalByRefObject
Implements ICloneable, IDisposable
Vererbung
GraphicsPath
Implementiert

Hinweise

Hinweis

In .NET 6 und höher wird das System.Drawing.Common-Paket,das diesen Typ enthält, nur auf Windows Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps verursacht Warnungen zur Kompilierzeit und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur für Windows unterstützt.

Anwendungen verwenden Pfade, um Gliederungen von Formen zu zeichnen, die Innenbereiche von Shapes zu füllen und Clippingbereiche zu erstellen. Das Grafikmodul verwaltet die Koordinaten geometrischer Formen in einem Pfad im Weltkoordinatenraum.

Ein Pfad kann aus einer beliebigen Anzahl von Zahlen (Unterpfaden) bestehen. Jede Abbildung besteht entweder aus einer Sequenz verbundener Linien und Kurven oder einem geometrischen Shape-Grundtyp. Der Ausgangspunkt einer Abbildung ist der erste Punkt in der Sequenz verbundener Linien und Kurven. Der Endpunkt ist der letzte Punkt in der Sequenz. Die Anfangs- und Endpunkte eines geometrischen Shape-Grundtyps werden durch die Grundtypspezifikation definiert.

Eine Abbildung, die aus einer Sequenz verbundener Linien und Kurven besteht (deren Start- und Endpunkte möglicherweise übereinstimmen) ist eine offene Abbildung, es sei denn, es wird explizit geschlossen. Eine Abbildung kann explizit geschlossen werden, indem Sie die CloseFigure Methode verwenden, die die aktuelle Abbildung schließt, indem Sie eine Linie von der Endpunktlinie mit dem Ausgangspunkt verbinden. Eine Abbildung, die aus einem geometrischen Shape-Grundtyp besteht, ist eine geschlossene Abbildung.

Zum Ausfüllen und Clipping (z. B. wenn ein Pfad mithilfe FillPathgerendert wird), werden alle geöffneten Zahlen geschlossen, indem sie eine Zeile aus dem ersten Punkt der Abbildung zu seinem letzten Punkt hinzufügen.

Eine neue Abbildung wird implizit gestartet, wenn ein Pfad erstellt wird oder wenn eine Abbildung geschlossen wird. Eine neue Abbildung wird explizit erstellt, wenn die StartFigure Methode aufgerufen wird.

Wenn ein geometrischer Shape-Grundtyp einem Pfad hinzugefügt wird, fügt es eine Abbildung hinzu, die die geometrische Form enthält, und beginnt auch implizit eine neue Abbildung. Folglich gibt es immer eine aktuelle Figur in einem Pfad. Wenn Linien und Kurven zu einem Pfad hinzugefügt werden, wird eine implizite Linie nach Bedarf hinzugefügt, um den Endpunkt der aktuellen Abbildung mit dem Ausgangspunkt der neuen Linien und Kurven zu verbinden, um eine Reihe verbundener Linien und Kurven zu bilden.

Eine Abbildung hat eine Richtung, die beschreibt, wie Linien- und Kurvensegmente zwischen dem Ausgangspunkt und dem Endpunkt nachverfolgt werden. Die Richtung wird in der Reihenfolge definiert, in der Linien und Kurven zu einer Abbildung hinzugefügt werden oder durch den geometrischen Shape-Grundtyp definiert werden. Die Richtung wird verwendet, um die Inneren des Pfads für die Klammer und Füllung zu bestimmen.

Konstruktoren

GraphicsPath()

Initialisiert eine neue Instanz der GraphicsPath-Klasse mit dem FillMode-Wert Alternate.

GraphicsPath(FillMode)

Initialisiert eine neue Instanz der GraphicsPath-Klasse mit der angegebenen FillMode-Enumeration.

GraphicsPath(Point[], Byte[])

Initialisiert eine neue Instanz der GraphicsPath-Klasse mit dem angegebenen PathPointType-Array und dem angegebenen Point-Array.

GraphicsPath(Point[], Byte[], FillMode)

Initialisiert eine neue Instanz der GraphicsPath-Klasse mit dem angegebenen PathPointType-Array, dem angegebenen Point-Array und dem angegebenen FillMode-Enumerationselement.

GraphicsPath(PointF[], Byte[])

Initialisiert eine neue Instanz des GraphicsPath-Arrays mit dem angegebenen PathPointType-Array und dem angegebenen PointF-Array.

GraphicsPath(PointF[], Byte[], FillMode)

Initialisiert eine neue Instanz des GraphicsPath-Arrays mit dem angegebenen PathPointType-Array, dem angegebenen PointF-Array und dem angegebenen FillMode-Enumerationselement.

Eigenschaften

FillMode

Ruft eine FillMode-Enumeration ab, die bestimmt, wie das Innere der Formen in diesem GraphicsPath gefüllt wird, oder legt diese fest.

PathData

Ruft ein PathData-Objekt ab, das Arrays von Punkten (points) und Typen (types) für diesen GraphicsPath kapselt.

PathPoints

Ruft die Punkte im Pfad ab.

PathTypes

Ruft die Typen der entsprechenden Punkte im PathPoints-Array ab.

PointCount

Ruft die Anzahl der Elemente in PathPoints oder im PathTypes-Array ab.

Methoden

AddArc(Int32, Int32, Int32, Int32, Single, Single)

Fügt einen Ellipsenbogen an die aktuelle Figur an.

AddArc(Rectangle, Single, Single)

Fügt einen Ellipsenbogen an die aktuelle Figur an.

AddArc(RectangleF, Single, Single)

Fügt einen Ellipsenbogen an die aktuelle Figur an.

AddArc(Single, Single, Single, Single, Single, Single)

Fügt einen Ellipsenbogen an die aktuelle Figur an.

AddBezier(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Fügt der aktuellen Figur eine kubische Bézierkurve hinzu.

AddBezier(Point, Point, Point, Point)

Fügt der aktuellen Figur eine kubische Bézierkurve hinzu.

AddBezier(PointF, PointF, PointF, PointF)

Fügt der aktuellen Figur eine kubische Bézierkurve hinzu.

AddBezier(Single, Single, Single, Single, Single, Single, Single, Single)

Fügt der aktuellen Figur eine kubische Bézierkurve hinzu.

AddBeziers(Point[])

Fügt der aktuellen Figur eine Abfolge verbundener kubischer Bézierkurven hinzu.

AddBeziers(PointF[])

Fügt der aktuellen Figur eine Abfolge verbundener kubischer Bézierkurven hinzu.

AddClosedCurve(Point[])

Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

AddClosedCurve(Point[], Single)

Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

AddClosedCurve(PointF[])

Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

AddClosedCurve(PointF[], Single)

Fügt diesem Pfad eine geschlossene Kurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

AddCurve(Point[])

Fügt der aktuellen Figur eine Splinekurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

AddCurve(Point[], Int32, Int32, Single)

Fügt der aktuellen Figur eine Splinekurve hinzu.

AddCurve(Point[], Single)

Fügt der aktuellen Figur eine Splinekurve hinzu.

AddCurve(PointF[])

Fügt der aktuellen Figur eine Splinekurve hinzu. Es wird eine Cardinal-Splinekurve verwendet, weil die Kurve durch jeden der Punkte im Array verläuft.

AddCurve(PointF[], Int32, Int32, Single)

Fügt der aktuellen Figur eine Splinekurve hinzu.

AddCurve(PointF[], Single)

Fügt der aktuellen Figur eine Splinekurve hinzu.

AddEllipse(Int32, Int32, Int32, Int32)

Fügt dem aktuellen Pfad eine Ellipse hinzu.

AddEllipse(Rectangle)

Fügt dem aktuellen Pfad eine Ellipse hinzu.

AddEllipse(RectangleF)

Fügt dem aktuellen Pfad eine Ellipse hinzu.

AddEllipse(Single, Single, Single, Single)

Fügt dem aktuellen Pfad eine Ellipse hinzu.

AddLine(Int32, Int32, Int32, Int32)

Fügt ein Liniensegment an die aktuelle Figur an.

AddLine(Point, Point)

Fügt ein Liniensegment an diesen GraphicsPath an.

AddLine(PointF, PointF)

Fügt ein Liniensegment an diesen GraphicsPath an.

AddLine(Single, Single, Single, Single)

Fügt ein Liniensegment an diesen GraphicsPath an.

AddLines(Point[])

Fügt eine Abfolge verbundener Liniensegmente an das Ende dieses GraphicsPath an.

AddLines(PointF[])

Fügt eine Abfolge verbundener Liniensegmente an das Ende dieses GraphicsPath an.

AddPath(GraphicsPath, Boolean)

Fügt den angegebenen GraphicsPath an diesen Pfad an.

AddPie(Int32, Int32, Int32, Int32, Single, Single)

Fügt diesem Pfad den Umriss einer Kreisform hinzu.

AddPie(Rectangle, Single, Single)

Fügt diesem Pfad den Umriss einer Kreisform hinzu.

AddPie(Single, Single, Single, Single, Single, Single)

Fügt diesem Pfad den Umriss einer Kreisform hinzu.

AddPolygon(Point[])

Fügt diesem Pfad ein Vieleck hinzu.

AddPolygon(PointF[])

Fügt diesem Pfad ein Vieleck hinzu.

AddRectangle(Rectangle)

Fügt diesem Pfad ein Rechteck hinzu.

AddRectangle(RectangleF)

Fügt diesem Pfad ein Rechteck hinzu.

AddRectangles(Rectangle[])

Fügt diesem Pfad ein Reihe von Rechtecken hinzu.

AddRectangles(RectangleF[])

Fügt diesem Pfad ein Reihe von Rechtecken hinzu.

AddString(String, FontFamily, Int32, Single, Point, StringFormat)

Fügt diesem Pfad eine Textzeichenfolge hinzu.

AddString(String, FontFamily, Int32, Single, PointF, StringFormat)

Fügt diesem Pfad eine Textzeichenfolge hinzu.

AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)

Fügt diesem Pfad eine Textzeichenfolge hinzu.

AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)

Fügt diesem Pfad eine Textzeichenfolge hinzu.

ClearMarkers()

Löscht alle Marker aus diesem Pfad.

Clone()

Erstellt eine genaue Kopie von diesem Pfad.

CloseAllFigures()

Schließt alle geöffneten Figuren in diesem Pfad und beginnt eine neue Figur. Jede geöffnete Figur wird geschlossen, indem ihr End- und Anfangspunkt durch eine Linie verbunden werden.

CloseFigure()

Schließt die aktuelle Figur und beginnt eine neue. Wenn die aktuelle Figur eine Abfolge verbundener Linien und Kurven enthält, schließt die Methode die Schleife, indem End- und Anfangspunkt durch eine Linie verbunden werden.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle von dieser GraphicsPath verwendeten Ressourcen frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Finalize()

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.

Flatten()

Konvertiert jede Kurve in diesem Pfad in eine Abfolge verbundener Liniensegmente.

Flatten(Matrix)

Wendet die angegebene Transformation an und konvertiert dann jede Kurve in diesem GraphicsPath in eine Abfolge verbundener Liniensegmente.

Flatten(Matrix, Single)

Konvertiert jede Kurve in diesem GraphicsPath in eine Abfolge verbundener Liniensegmente.

GetBounds()

Gibt ein Rechteck zurück, das diesen GraphicsPath umschließt.

GetBounds(Matrix)

Gibt ein Rechteck zurück, das diesen GraphicsPath umschließt, wenn dieser Pfad durch die angegebene Matrix transformiert wird.

GetBounds(Matrix, Pen)

Gibt ein Rechteck zurück, das diesen GraphicsPath umschließt, wenn der aktuelle Pfad durch die angegebene Matrix transformiert und mit dem angegebenen Pen gezeichnet wird.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLastPoint()

Ruft den letzten Punkt im PathPoints-Array dieses GraphicsPath ab.

GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
IsOutlineVisible(Int32, Int32, Pen)

Zeigt an, ob sich der angegebene Punkt auf bzw. unter dem Umriss dieses GraphicsPath befindet, wenn er mit dem angegebenen Pen gezeichnet wurde.

IsOutlineVisible(Int32, Int32, Pen, Graphics)

Zeigt an, ob sich der angegebene Punkt auf bzw. unter dem Umriss dieses GraphicsPath befindet, wenn er unter Verwendung des angegebenen Pen-Objekts mit dem angegebenen Graphics gezeichnet wurde.

IsOutlineVisible(Point, Pen)

Zeigt an, ob sich der angegebene Punkt auf bzw. unter dem Umriss dieses GraphicsPath befindet, wenn er mit dem angegebenen Pen gezeichnet wurde.

IsOutlineVisible(Point, Pen, Graphics)

Zeigt an, ob sich der angegebene Punkt auf bzw. unter dem Umriss dieses GraphicsPath befindet, wenn er unter Verwendung des angegebenen Pen-Objekts mit dem angegebenen Graphics gezeichnet wurde.

IsOutlineVisible(PointF, Pen)

Zeigt an, ob sich der angegebene Punkt auf bzw. unter dem Umriss dieses GraphicsPath befindet, wenn er mit dem angegebenen Pen gezeichnet wurde.

IsOutlineVisible(PointF, Pen, Graphics)

Zeigt an, ob sich der angegebene Punkt auf bzw. unter dem Umriss dieses GraphicsPath befindet, wenn er unter Verwendung des angegebenen Pen-Objekts mit dem angegebenen Graphics gezeichnet wurde.

IsOutlineVisible(Single, Single, Pen)

Zeigt an, ob sich der angegebene Punkt auf bzw. unter dem Umriss dieses GraphicsPath befindet, wenn er mit dem angegebenen Pen gezeichnet wurde.

IsOutlineVisible(Single, Single, Pen, Graphics)

Zeigt an, ob sich der angegebene Punkt auf bzw. unter dem Umriss dieses GraphicsPath befindet, wenn er unter Verwendung des angegebenen Pen-Objekts mit dem angegebenen Graphics gezeichnet wurde.

IsVisible(Int32, Int32)

Gibt an, dass der angegebene Punkt in diesem GraphicsPath enthalten ist.

IsVisible(Int32, Int32, Graphics)

Gibt an, dass der angegebene Punkt in diesem GraphicsPath enthalten ist und dass dabei das angegebene Graphics-Objekt verwendet wird.

IsVisible(Point)

Gibt an, dass der angegebene Punkt in diesem GraphicsPath enthalten ist.

IsVisible(Point, Graphics)

Gibt an, dass der angegebene Punkt in diesem GraphicsPath enthalten ist.

IsVisible(PointF)

Gibt an, dass der angegebene Punkt in diesem GraphicsPath enthalten ist.

IsVisible(PointF, Graphics)

Gibt an, dass der angegebene Punkt in diesem GraphicsPath enthalten ist.

IsVisible(Single, Single)

Gibt an, dass der angegebene Punkt in diesem GraphicsPath enthalten ist.

IsVisible(Single, Single, Graphics)

Gibt an, ob der angegebene Punkt in diesem GraphicsPath im sichtbaren Clipbereich des angegebenen Graphics-Objekts enthalten ist.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
Reset()

Leert das PathPoints-Array und das PathTypes-Array und legt FillMode auf Alternate fest.

Reverse()

Kehrt die Reihenfolge der Punkte im PathPoints-Array dieses GraphicsPath um.

SetMarkers()

Setzt einen Marker für diesen GraphicsPath.

StartFigure()

Startet eine neue Figur, ohne die aktuelle zu schließen. Alle nachfolgenden Punkte, die dem Pfad hinzugefügt werden, werden dieser neuen Figur hinzugefügt.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
Transform(Matrix)

Weist diesem GraphicsPath eine Transformationsmatrix zu.

Warp(PointF[], RectangleF)

Weist diesem GraphicsPath eine durch ein Rechteck und ein Parallelogramm definierte Verzerrungstransformation zu.

Warp(PointF[], RectangleF, Matrix)

Weist diesem GraphicsPath eine durch ein Rechteck und ein Parallelogramm definierte Verzerrungstransformation zu.

Warp(PointF[], RectangleF, Matrix, WarpMode)

Weist diesem GraphicsPath eine durch ein Rechteck und ein Parallelogramm definierte Verzerrungstransformation zu.

Warp(PointF[], RectangleF, Matrix, WarpMode, Single)

Weist diesem GraphicsPath eine durch ein Rechteck und ein Parallelogramm definierte Verzerrungstransformation zu.

Widen(Pen)

Fügt dem Pfad einen weiteren Umriss hinzu.

Widen(Pen, Matrix)

Fügt dem GraphicsPath einen weiteren Umriss hinzu.

Widen(Pen, Matrix, Single)

Ersetzt diesen GraphicsPath durch Kurven, die den Bereich einschließen, der beim Zeichnen des Pfads mithilfe des angegebenen Stifts ausgefüllt wird.

Gilt für

Siehe auch