路径标记语法

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

先决条件

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

StreamGeometry and PathFigureCollection Mini-Languages

WPF 提供了两个类,它们提供了用于描述几何路径的微型语言:StreamGeometryPathFigureCollection

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

有关 PathGeometryStreamGeometry 对象之间的差异的详细信息,请参阅几何概述

有关空格的注意事项

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

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

语法

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

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

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

PathFigureCollection XAML Attribute Usage
< object property =" figureDescription[ figureDescription]* " ... />
术语 说明
fillRule System.Windows.Media.FillRule

指定 StreamGeometry 是使用 EvenOdd 还是 NonzeroFillRule

- F0 指定 EvenOdd 填充规则。
- F1 指定 Nonzero 填充规则。

如果省略该命令,子路径将使用默认行为,即 EvenOdd。 如果指定该命令,须先设置命令。
figureDescription 图形由一个移动命令,绘制命令和一个可选的关闭命令组成。

moveCommand drawCommands [ closeCommand ]
moveCommand 用于指定图形起点的移动命令。 请参阅移动命令部分。
drawCommands 用于描述图形内容的一个或多个绘图命令。 请参阅绘制命令部分。
closeCommand 用于关闭图形的可选关闭命令。 请参阅关闭命令部分。

移动命令

指定新图形的起点。

语法
M startPoint

- 或 -

m startPoint
术语 说明
startPoint System.Windows.Point

新图形的起点。

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

绘制命令

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

可以使用大写或小写字母输入每个命令:大写字母表示绝对值,小写字母表示相对值:该线段的控制点相对于前面示例的终点。

提示

当按顺序输入多个相同类型的命令时,可以省略重复的命令输入;例如,L 100,200 300,400 相当于 L 100,200 L 300,400

直线命令

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

语法
L endPoint

- 或 -

l endPoint
术语 说明
endPoint System.Windows.Point

线条的终点。

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

水平线命令

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

语法
H x

- 或 -

h x
术语 说明
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 是有效曲线命令的示例。

语法
C controlPoint1controlPoint2endPoint

- 或 -

c controlPoint1controlPoint2endPoint
术语 说明
controlPoint1 System.Windows.Point

曲线的第一个控制点,它决定曲线的起始切线。
controlPoint2 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 是一个有效的平滑三次贝塞尔曲线命令。

语法
S controlPoint2endPoint

- 或 -

s controlPoint2endPoint
术语 说明
controlPoint2 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 是一个有效值。

另请参阅