GraphicsPath 类

定义

命名空间:

System.Drawing.Drawing2D

程序集:

System.Drawing.Common.dll

Source:

GraphicsPath.cs

表示一系列连接的线条和曲线。 无法继承此类。

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

继承

Object

MarshalByRefObject

GraphicsPath

实现

ICloneable IDisposable

注解

Note

在 .NET 6 及更高版本中，包含此类型的 System.Drawing.Common 包 仅支持在 Windows 操作系统上运行。 在跨平台应用中使用此类型会导致编译时警告和运行时异常。 有关详细信息，请参阅 仅在 Windows 上支持的 System.Drawing.Common。

应用程序使用路径绘制形状的轮廓、填充形状的内部以及创建剪裁区域。 图形引擎维护世界坐标空间中路径中几何形状的坐标。

路径可以由任意数量的数字（子路径）组成。 每个图都由连接线和曲线序列或几何形状基元组成。 图的起点是连接线和曲线序列中的第一个点。 终点是序列中的最后一个点。 几何形状基元的起点和终点由基元规范定义。

由连接线和曲线序列组成的图（其起点和终点可能是巧合）是一个开放数字，除非它显式关闭。 可以通过使用 CloseFigure 方法显式关闭图形，该方法通过将一行从终点连接到起点来关闭当前图。 由几何形状基元组成的图形是一个封闭图。

为了填充和剪裁（例如，如果使用路径呈现 FillPath），所有打开的数字都通过从图的第一个点向最后一个点添加一行来关闭。

在创建路径或关闭图形时隐式启动新图形。 调用方法时 StartFigure 显式创建一个新图。

将几何形状基元添加到路径时，它会添加包含几何形状的图形，并隐式启动一个新图形。 因此，路径中始终存在当前数字。 将线条和曲线添加到路径时，需要添加一条隐式线条，以便将当前图形的终点连接到新线条和曲线的起点，以形成连接线和曲线序列。

图有一个方向，描述起点和终点之间的直线和曲线段的跟踪方式。 方向按照将线条和曲线添加到图形的顺序定义，或由几何形状基元定义。 该方向用于确定剪裁和填充的路径内部。

构造函数

名称	说明
GraphicsPath()	用FillMode值为 Alternate.. 初始化类的新实例GraphicsPath。
GraphicsPath(FillMode)	使用指定的FillMode枚举初始化类的新实例GraphicsPath。
GraphicsPath(Point[], Byte[], FillMode)	使用指定的PathPointType数组Point和指定的FillMode枚举元素初始化类的新实例GraphicsPath。
GraphicsPath(Point[], Byte[])	使用指定的PathPointType和Point数组初始化类的新实例GraphicsPath。
GraphicsPath(PointF[], Byte[], FillMode)	使用指定的PathPointType数组和FillModePointF指定的枚举元素初始化数组的新实例GraphicsPath。
GraphicsPath(PointF[], Byte[])	使用指定的PathPointType数组和PointF数组初始化数组的新实例GraphicsPath。
GraphicsPath(ReadOnlySpan<Point>, ReadOnlySpan<Byte>, FillMode)	使用指定的PathPointType数组Point和指定的FillMode枚举元素初始化类的新实例GraphicsPath。
GraphicsPath(ReadOnlySpan<PointF>, ReadOnlySpan<Byte>, FillMode)	使用指定的PathPointType数组Point和指定的FillMode枚举元素初始化类的新实例GraphicsPath。

属性

名称	说明
FillMode	获取或设置一个 FillMode 枚举，该枚举确定如何填充形状 GraphicsPath 的内部。
PathData	获取一个 PathData 封装此 GraphicsPath点和类型的数组。
PathPoints	获取路径中的点。
PathTypes	获取数组中 PathPoints 相应点的类型。
PointCount	获取或PathTypes数组中的PathPoints元素数。

方法

名称	说明
AddArc(Int32, Int32, Int32, Int32, Single, Single)	将椭圆弧追加到当前图形。
AddArc(Rectangle, Single, Single)	将椭圆弧追加到当前图形。
AddArc(RectangleF, Single, Single)	将椭圆弧追加到当前图形。
AddArc(Single, Single, Single, Single, Single, Single)	将椭圆弧追加到当前图形。
AddBezier(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	向当前图中添加一条立方贝塞尔曲线。
AddBezier(Point, Point, Point, Point)	向当前图中添加一条立方贝塞尔曲线。
AddBezier(PointF, PointF, PointF, PointF)	向当前图中添加一条立方贝塞尔曲线。
AddBezier(Single, Single, Single, Single, Single, Single, Single, Single)	向当前图中添加一条立方贝塞尔曲线。
AddBeziers(Point[])	将连接的立方贝塞尔曲线序列添加到当前图中。
AddBeziers(PointF[])	将连接的立方贝塞尔曲线序列添加到当前图中。
AddBeziers(ReadOnlySpan<Point>)	将连接的立方贝塞尔曲线序列添加到当前图中。
AddBeziers(ReadOnlySpan<PointF>)	将连接的立方贝塞尔曲线序列添加到当前图中。
AddClosedCurve(Point[], Single)	向此路径添加封闭曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddClosedCurve(Point[])	向此路径添加封闭曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddClosedCurve(PointF[], Single)	向此路径添加封闭曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddClosedCurve(PointF[])	向此路径添加封闭曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddClosedCurve(ReadOnlySpan<Point>, Single)	向此路径添加封闭曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddClosedCurve(ReadOnlySpan<Point>)	向此路径添加封闭曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddClosedCurve(ReadOnlySpan<PointF>, Single)	向此路径添加封闭曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddClosedCurve(ReadOnlySpan<PointF>)	向此路径添加封闭曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddCurve(Point[], Int32, Int32, Single)	向当前图添加样条曲线。
AddCurve(Point[], Single)	向当前图添加样条曲线。
AddCurve(Point[])	向当前图添加样条曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddCurve(PointF[], Int32, Int32, Single)	向当前图添加样条曲线。
AddCurve(PointF[], Single)	向当前图添加样条曲线。
AddCurve(PointF[])	向当前图添加样条曲线。 使用基数样条曲线，因为曲线穿过数组中的每个点。
AddCurve(ReadOnlySpan<Point>, Single)	向当前图添加样条曲线。
AddCurve(ReadOnlySpan<Point>)	向当前图添加样条曲线。
AddCurve(ReadOnlySpan<PointF>, Single)	向当前图添加样条曲线。
AddCurve(ReadOnlySpan<PointF>)	向当前图添加样条曲线。
AddEllipse(Int32, Int32, Int32, Int32)	将省略号添加到当前路径。
AddEllipse(Rectangle)	将省略号添加到当前路径。
AddEllipse(RectangleF)	将省略号添加到当前路径。
AddEllipse(Single, Single, Single, Single)	将省略号添加到当前路径。
AddLine(Int32, Int32, Int32, Int32)	将折线段追加到当前图中。
AddLine(Point, Point)	将行段追加到此 GraphicsPath行段。
AddLine(PointF, PointF)	将行段追加到此 GraphicsPath行段。
AddLine(Single, Single, Single, Single)	将行段追加到此 GraphicsPath行段。
AddLines(Point[])	将一系列连接的线段追加到此 GraphicsPath末尾。
AddLines(PointF[])	将一系列连接的线段追加到此 GraphicsPath末尾。
AddLines(ReadOnlySpan<Point>)	将一系列连接的线段追加到此 GraphicsPath末尾。
AddLines(ReadOnlySpan<PointF>)	将一系列连接的线段追加到此 GraphicsPath末尾。
AddPath(GraphicsPath, Boolean)	将指定的 GraphicsPath 值追加到此路径。
AddPie(Int32, Int32, Int32, Int32, Single, Single)	将饼图形状的轮廓添加到此路径。
AddPie(Rectangle, Single, Single)	将饼图形状的轮廓添加到此路径。
AddPie(Single, Single, Single, Single, Single, Single)	将饼图形状的轮廓添加到此路径。
AddPolygon(Point[])	将多边形添加到此路径。
AddPolygon(PointF[])	将多边形添加到此路径。
AddPolygon(ReadOnlySpan<Point>)	将多边形添加到此路径。
AddPolygon(ReadOnlySpan<PointF>)	将多边形添加到此路径。
AddRectangle(Rectangle)	向此路径添加一个矩形。
AddRectangle(RectangleF)	向此路径添加一个矩形。
AddRectangles(ReadOnlySpan<Rectangle>)	将一系列矩形添加到此路径。
AddRectangles(ReadOnlySpan<RectangleF>)	将一系列矩形添加到此路径。
AddRectangles(Rectangle[])	将一系列矩形添加到此路径。
AddRectangles(RectangleF[])	将一系列矩形添加到此路径。
AddRoundedRectangle(Rectangle, Size)	向此路径添加一个圆角矩形。
AddRoundedRectangle(RectangleF, SizeF)	向此路径添加一个圆角矩形。
AddString(String, FontFamily, Int32, Single, Point, StringFormat)	将文本字符串添加到此路径。
AddString(String, FontFamily, Int32, Single, PointF, StringFormat)	将文本字符串添加到此路径。
AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat)	将文本字符串添加到此路径。
AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat)	将文本字符串添加到此路径。
ClearMarkers()	清除此路径中的所有标记。
Clone()	创建此路径的确切副本。
CloseAllFigures()	关闭此路径中的所有打开的数字，并启动一个新数字。 它通过将一行从终结点连接到其起点来关闭每个打开的数字。
CloseFigure()	关闭当前图并启动新图。 如果当前图包含连接线和曲线序列，则该方法通过将一条线从终结点连接到起点来关闭循环。
Dispose()	释放由此 GraphicsPath使用的所有资源。
Finalize()	允许对象在垃圾回收回收资源之前尝试释放资源并执行其他清理操作。
Flatten()	将此路径中的每个曲线转换为连接的线段序列。
Flatten(Matrix, Single)	将此 GraphicsPath 中的每个曲线转换为连接的线段序列。
Flatten(Matrix)	应用指定的转换，然后将此 GraphicsPath 中的每个曲线转换为连接的线段序列。
GetBounds()	返回一个矩形，该矩形对此进行 GraphicsPath绑定。
GetBounds(Matrix, Pen)	返回一个矩形，当当前路径由指定的Matrix和用指定的Pen绘制来转换时，该矩形将绑定此GraphicsPath范围。
GetBounds(Matrix)	返回一个矩形，该矩形在指定Matrix路径转换时绑定此GraphicsPath路径。
GetLastPoint()	获取此GraphicsPath数组中的PathPoints最后一个点。
GetPathPoints(Span<PointF>)	获取路径中的点。
GetPathTypes(Span<Byte>)	PathPointType获取路径中点的类型。
IsOutlineVisible(Int32, Int32, Pen, Graphics)	指示指定点是否包含在 的轮廓 GraphicsPath 中，当用指定的 Pen 和指定的 Graphics。
IsOutlineVisible(Int32, Int32, Pen)	指示使用指定Pen点绘制时，指定的点是否包含在 的GraphicsPath轮廓下。
IsOutlineVisible(Point, Pen, Graphics)	指示指定点是否包含在 的轮廓 GraphicsPath 中，当用指定的 Pen 和指定的 Graphics。
IsOutlineVisible(Point, Pen)	指示使用指定Pen点绘制时，指定的点是否包含在 的GraphicsPath轮廓下。
IsOutlineVisible(PointF, Pen, Graphics)	指示指定点是否包含在 的轮廓 GraphicsPath 中，当用指定的 Pen 和指定的 Graphics。
IsOutlineVisible(PointF, Pen)	指示使用指定Pen点绘制时，指定的点是否包含在 的GraphicsPath轮廓下。
IsOutlineVisible(Single, Single, Pen, Graphics)	指示指定点是否包含在 的轮廓 GraphicsPath 中，当用指定的 Pen 和指定的 Graphics。
IsOutlineVisible(Single, Single, Pen)	指示使用指定Pen点绘制时，指定的点是否包含在 的GraphicsPath轮廓下。
IsVisible(Int32, Int32, Graphics)	指示指定点是否包含在此 GraphicsPath范围内，使用指定的 Graphics点。
IsVisible(Int32, Int32)	指示指定点是否包含在此 GraphicsPath范围内。
IsVisible(Point, Graphics)	指示指定点是否包含在此 GraphicsPath范围内。
IsVisible(Point)	指示指定点是否包含在此 GraphicsPath范围内。
IsVisible(PointF, Graphics)	指示指定点是否包含在此 GraphicsPath范围内。
IsVisible(PointF)	指示指定点是否包含在此 GraphicsPath范围内。
IsVisible(Single, Single, Graphics)	指示指定点是否包含在 GraphicsPath 指定 Graphics可见的剪辑区域中。
IsVisible(Single, Single)	指示指定点是否包含在此 GraphicsPath范围内。
Reset()	清空 PathPoints 和 PathTypes 数组并设置 FillMode 到 Alternate。
Reverse()	反转此GraphicsPath数组中PathPoints点的顺序。
SetMarkers()	设置此 GraphicsPath标记。
StartFigure()	在不关闭当前图表的情况下启动新图。 添加到路径的所有后续点将添加到此新图中。
Transform(Matrix)	对此应用转换矩阵 GraphicsPath。
Warp(PointF[], RectangleF, Matrix, WarpMode, Single)	对此 GraphicsPath应用由矩形和平行四边形定义的扭曲转换。
Warp(PointF[], RectangleF, Matrix, WarpMode)	对此 GraphicsPath应用由矩形和平行四边形定义的扭曲转换。
Warp(PointF[], RectangleF, Matrix)	对此 GraphicsPath应用由矩形和平行四边形定义的扭曲转换。
Warp(PointF[], RectangleF)	对此 GraphicsPath应用由矩形和平行四边形定义的扭曲转换。
Warp(ReadOnlySpan<PointF>, RectangleF, Matrix, WarpMode, Single)	对此 GraphicsPath应用由矩形和平行四边形定义的扭曲转换。
Widen(Pen, Matrix, Single)	用曲线替换此 GraphicsPath 曲线，该曲线将用指定的笔绘制时填充的区域。
Widen(Pen, Matrix)	向 .添加其他大纲 GraphicsPath。
Widen(Pen)	向路径添加其他大纲。

另请参阅

• 构建和绘制路径