路径标记语法

项目
10/20/2023

尽管在 WPF 中的形状和基本图形概述和几何概述中描述了路径，但本主题还详细介绍了可用来使用 Extensible Application Markup Language (XAML) 更简洁地指定路径几何的强大且复杂的微型语言。

先决条件

若要了解本主题，应熟悉 Geometry 对象的基本功能。有关详细信息，请参阅几何概述。

StreamGeometry and PathFigureCollection Mini-Languages

WPF 提供了两个类，它们提供了用于描述几何路径的微型语言：StreamGeometry 和 PathFigureCollection。

设置 Geometry 类型的属性（例如 UIElement 元素的 Clip 属性或 Path 元素的 Data 属性）时，可以使用 StreamGeometry 微型语言。以下示例使用属性语法创建 StreamGeometry。
```
<Path Stroke="Black" Fill="Gray"
      Data="M 10,100 C 10,300 300,-200 300,100" />
```
在设置 PathGeometry 的 Figures 属性时，可以使用 PathFigureCollection 微型语言。以下示例使用属性语法为 PathGeometry 创建 PathFigureCollection。
```
<Path Stroke="Black" Fill="Gray">
  <Path.Data>
    <PathGeometry Figures="M 10,100 C 10,300 300,-200 300,100" />
  </Path.Data>
</Path>
```

从前面的示例中可以看出，两种微型语言非常相似。在可以使用 StreamGeometry 的任何情况下，都可以使用 PathGeometry；你应该使用它们中的哪一个呢？在创建路径后无需修改路径时，请使用 StreamGeometry；如果需要修改路径，请使用 PathGeometry。

有关 PathGeometry 和 StreamGeometry 对象之间的差异的详细信息，请参阅几何概述。

有关空格的注意事项

为简洁起见，随后的语法部分中显示一个空格，但在显示一个空格的地方，多个空格也可以接受。

两个数字之间不必用逗号或空格分隔，但仅适用于生成的字符串明确时。例如，2..3 实际是两个数字：“2.”和“.3”。同样，2-3 是“2”和“-3”。命令前面或后面也无需加空格。

语法

StreamGeometry 的 Extensible Application Markup Language (XAML) 属性用法语法由可选的 FillRule 值和一个或多个图形描述组成。

StreamGeometry XAML 属性用法
`<`objectproperty`="`[ `fillRule`] `figureDescription`[ `figureDescription`]* `" ... />`

PathFigureCollection 的 Extensible Application Markup Language (XAML) 属性用法语法由一个或多个图形描述组成。

PathFigureCollection XAML Attribute Usage
`<`objectproperty`="figureDescription`[ `figureDescription`]* `" ... />`

术语	说明
fillRule	System.Windows.Media.FillRule 指定 StreamGeometry 是使用 EvenOdd 还是 Nonzero FillRule。 - `F0` 指定 EvenOdd 填充规则。 - `F1` 指定 Nonzero 填充规则。如果省略该命令，子路径将使用默认行为，即 EvenOdd。如果指定该命令，须先设置命令。
figureDescription	图形由一个移动命令，绘制命令和一个可选的关闭命令组成。 `moveCommand` `drawCommands` `[` `closeCommand` `]`
moveCommand	用于指定图形起点的移动命令。请参阅移动命令部分。
drawCommands	用于描述图形内容的一个或多个绘图命令。请参阅绘制命令部分。
closeCommand	用于关闭图形的可选关闭命令。请参阅关闭命令部分。

移动命令

指定新图形的起点。

语法
startPoint`M` - 或 - startPoint`m`

术语	说明
startPoint	System.Windows.Point 新图形的起点。

大写字母 M 表明 startPoint 是一个绝对值；小写字母 m 表明 startPoint 是对前一点的偏移，如果都不存在的话，则为 (0,0)。如果在移动命令之后列出多个点，可以绘制一条连接到这些点的直线，尽管已指定了直线命令。

绘制命令

绘制命令可以由几个形状命令组成。以下形状命令可用：直线、水平线、竖线、三次贝塞尔曲线、二次贝塞尔曲线、平滑三次贝塞尔曲线、平滑二次贝塞尔曲线和椭圆弧。

可以使用大写或小写字母输入每个命令：大写字母表示绝对值，小写字母表示相对值：该线段的控制点相对于前面示例的终点。当按顺序输入多个相同类型的命令时，可以省略重复的命令输入；例如，L 100,200 300,400 相当于 L 100,200 L 300,400。下表描述了“移动”和“绘制”命令。

直线命令

在当前点和指定的终点之间创建一条直线。 l 20 30 和 L 20,30 是有效的“直线”命令示例。

语法
endPoint`L` - 或 - endPoint`l`

术语	说明
endPoint	System.Windows.Point 线条的终点。

大写字母 L 表明 endPoint 是一个绝对值；小写字母 l 表明 endPoint 是对前一点的偏移，如果都不存在的话，则为 (0,0)。

水平线命令

在当前点和指定的 x 坐标之间创建一条水平线。 H 90 是有效水平线命令的示例。

语法
x`H` - 或 - x`h`

术语	说明
x	System.Double 线条终点的 x 坐标。

大写字母 H 表明 x 是一个绝对值；小写字母 h 表明 x 是对前一点的偏移，如果都不存在的话，则为 (0,0)。

竖线命令

在当前点和指定的 y 坐标之间创建一条竖线。 v 90 是有效竖线命令的示例。

语法
`V`y - 或 - `v`y

术语	说明
y	System.Double 直线终点的 y 坐标。

大写字母 V 表明 y 是一个绝对值；小写字母 v 表明 y 是对前一点的偏移，如果都不存在的话，则为 (0,0)。

三次贝塞尔曲线命令

通过使用两个指定的控制点（controlPoint1 和 controlPoint2），在当前点和指定的终点之间创建三次贝塞尔曲线。 C 100,200 200,400 300,200 是有效曲线命令的示例。

语法
`CcontrolPoint`1`controlPoint`2`endPoint` - 或 - `ccontrolPoint`1`controlPoint`2`endPoint`

术语	说明
`controlPoint`1	System.Windows.Point 曲线的第一个控制点，它决定曲线的起始切线。
`controlPoint`2	System.Windows.Point 曲线的第二个控制点，它决定曲线的结束切线。
`endPoint`	System.Windows.Point 绘制曲线将通过的点。

二次贝塞尔曲线命令

使用指定的控制点 (controlPoint)，在当前点和指定的终点之间创建二次贝塞尔曲线。 q 100,200 300,200 为有效二次贝塞尔曲线命令的示例。

语法
`Q` `controlPoint` `endPoint` - 或 - `q` `controlPoint` `endPoint`

术语	说明
`controlPoint`	System.Windows.Point 曲线的控制点，它决定曲线的开始和结束切线。
`endPoint`	System.Windows.Point 绘制曲线将通过的点。

平滑三次贝塞尔曲线命令

在当前点和指定的终点之间创建三次贝塞尔曲线。假设第一控制点为相对当前点前一命令的第二控制点的反射。如果没有前一命令或如果前一命令不是三次贝塞尔曲线命令或平滑三次贝塞尔曲线命令，则假设第一个控制点与当前点重合。第二个控制点（曲线末尾的控制点）由 controlPoint2 指定。例如，S 100,200 200,300 是一个有效的平滑三次贝塞尔曲线命令。

语法
`ScontrolPoint`2`endPoint` - 或 - `scontrolPoint`2`endPoint`

术语	说明
`controlPoint`2	System.Windows.Point 曲线的控制点，它决定曲线的结束切线。
`endPoint`	System.Windows.Point 绘制曲线将通过的点。

平滑二次贝塞尔曲线命令

在当前点和指定的终点之间创建二次贝塞尔曲线。假设控制点为相对于当前点前一命令的控制点的反射。如果没有前一命令或如果前一命令不是二次贝塞尔曲线命令或平滑二次贝塞尔曲线命令，则控制点与当前点重合。

语法
`T` `endPoint` - 或 - `t` `endPoint`

术语	说明
`endPoint`	System.Windows.Point 绘制曲线将通过的点。

椭圆弧命令

在当前点和指定的终点之间创建一个椭圆弧。

语法
`A` `size` `rotationAngle` `isLargeArcFlag` `sweepDirectionFlag` `endPoint` - 或 - `a` `size` `rotationAngle` `isLargeArcFlag` `sweepDirectionFlag` `endPoint`

术语	说明
`size`	System.Windows.Size 圆弧的 x 轴和 y 轴半径。
`rotationAngle`	System.Double 椭圆的旋转，以度为单位。
`isLargeArcFlag`	如果圆弧角度应为 180 度或更大，请设置为 1，否则设置为 0。
`sweepDirectionFlag`	如果以正角方向绘制圆弧，请设置为 1；否则设置为 0。
`endPoint`	System.Windows.Point 绘制弧将通过的点。

关闭命令

结束当前图形，并创建一条将当前点连接到图形起点的直线。此命令可以在图形最后一段与第一段之间创建一条连接线（角）。

语法
`Z` - 或 - `z`

点语法

描述 (0,0) 为左上角的点的 x 坐标和 y 坐标。

语法
`x` `,` `y` - 或 - `x` `y`

术语	说明
`x`	System.Double 该点的 x 坐标。
`y`	System.Double 该点的 y 坐标。

特殊值

除了标准数值外，还可使用以下特殊值。这些数值区分大小写。

无穷大
表示 Double.PositiveInfinity。

-Infinity
表示 Double.NegativeInfinity。

NaN
表示 Double.NaN。

也可使用科学计数法。例如，+1.e17 是一个有效值。