Teilen über


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öheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps verursacht Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Anwendungen verwenden Pfade, um Konturen von Formen zu zeichnen, die Innenbereiche von Formen zu füllen und Beschneidungsbereiche zu erstellen. Die Grafik-Engine verwaltet die Koordinaten geometrischer Formen in einem Pfad im Weltkoordinatenraum.

Ein Pfad kann aus einer beliebigen Anzahl von Abbildungen (Unterpfaden) bestehen. Jede Figur besteht entweder aus einer Sequenz verbundener Linien und Kurven oder einer geometrischen Form primitiv. 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 Grundtyps einer geometrischen Form werden durch die Primitive-Spezifikation definiert.

Eine Abbildung, die aus einer Sequenz verbundener Linien und Kurven besteht (deren Anfangs- und Endpunkte zufällig sein können) ist eine offene Abbildung, es sei denn, sie wird explizit geschlossen. Eine Abbildung kann explizit mit der CloseFigure -Methode geschlossen werden, die die aktuelle Abbildung schließt, indem eine Linie vom Endpunkt mit dem Ausgangspunkt verbunden wird. Eine Figur, die aus einem geometrischen Formgrundtyp besteht, ist eine geschlossene Figur.

Zum Füllen und Beschneiden (z. B. wenn ein Pfad mit FillPathgerendert wird) werden alle geöffneten Abbildungen geschlossen, indem eine Linie vom ersten Punkt der Abbildung bis zum letzten Punkt hinzugefügt wird.

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

Wenn einem Pfad ein Grundtyp einer geometrischen Form hinzugefügt wird, fügt er eine Figur hinzu, die die geometrische Form enthält, und startet implizit eine neue Figur. Folglich befindet sich immer eine aktuelle Figur in einem Pfad. Wenn Linien und Kurven zu einem Pfad hinzugefügt werden, wird bei Bedarf eine implizite Linie hinzugefügt, um den Endpunkt der aktuellen Abbildung mit dem Ausgangspunkt der neuen Linien und Kurven zu verbinden, um eine Sequenz verbundener Linien und Kurven zu bilden.

Eine Abbildung hat eine Richtung, die beschreibt, wie Linien- und Kurvensegmente zwischen dem Startpunkt und dem Endpunkt nachverfolgt werden. Die Richtung wird in der Reihenfolge definiert, in der Linien und Kurven zu einer Figur hinzugefügt werden, oder wird durch den Grundtyp der geometrischen Form definiert. Die Richtung wird verwendet, um die Inneren des Pfads zum Beschneiden und Füllen 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.

GraphicsPath(ReadOnlySpan<Point>, ReadOnlySpan<Byte>, FillMode)

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

GraphicsPath(ReadOnlySpan<PointF>, ReadOnlySpan<Byte>, FillMode)

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

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.

AddBeziers(ReadOnlySpan<Point>)

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

AddBeziers(ReadOnlySpan<PointF>)

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

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.

AddClosedCurve(ReadOnlySpan<Point>)

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

AddClosedCurve(ReadOnlySpan<Point>, Single)

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

AddClosedCurve(ReadOnlySpan<PointF>)

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

AddClosedCurve(ReadOnlySpan<PointF>, Single)

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

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.

AddCurve(ReadOnlySpan<Point>)

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

AddCurve(ReadOnlySpan<Point>, Single)

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

AddCurve(ReadOnlySpan<PointF>)

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

AddCurve(ReadOnlySpan<PointF>, Single)

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

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.

AddLines(ReadOnlySpan<Point>)

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

AddLines(ReadOnlySpan<PointF>)

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

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.

AddPolygon(ReadOnlySpan<Point>)

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

AddPolygon(ReadOnlySpan<PointF>)

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

AddRectangle(Rectangle)

Fügt diesem Pfad ein Rechteck hinzu.

AddRectangle(RectangleF)

Fügt diesem Pfad ein Rechteck hinzu.

AddRectangles(ReadOnlySpan<Rectangle>)

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

AddRectangles(ReadOnlySpan<RectangleF>)

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

AddRectangles(Rectangle[])

Fügt diesem Pfad ein Reihe von Rechtecken hinzu.

AddRectangles(RectangleF[])

Fügt diesem Pfad ein Reihe von Rechtecken hinzu.

AddRoundedRectangle(Rectangle, Size)

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

AddRoundedRectangle(RectangleF, SizeF)

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

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)
GetPathPoints(Span<PointF>)

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

GetPathTypes(Span<Byte>)

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

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.

Warp(ReadOnlySpan<PointF>, RectangleF, Matrix, WarpMode, Single)

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

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:

Weitere Informationen