移动和绘制命令语法

  • 项目

了解移动和绘制命令（小型语言），可用于将路径几何图形指定为 XAML 属性值。 移动和绘制命令由许多设计和图形工具使用，用于按序列化和交换格式输出矢量图形或形状。

使用移动和绘制命令字符串的属性

移动和绘制命令语法受 XAML 的内部类型转换器支持，可分析命令并生成运行时图形表示形式。 此表示形式基本上是一组用于演示的完成矢量。 矢量本身不会完成表示细节；你仍然需要在元素上设置其他值。 对于 Path 对象，你还需要适用于 Fill、Stroke 和其他属性的值，然后 Path 必须通过某种途径连接到可视化树。 对于 PathIcon 对象，设置 Foreground 属性。

在 Windows 运行时中存在两种可使用字符串表示移动和绘制命令的属性：Path.Data 和 PathIcon.Data。 如果你通过指定移动和绘制命令设置其中一个属性，通常会将其设置为 XAML 属性值以及该元素的其他所需属性。 在未获取细节的情况下，如此处所示：

<Path x:Name="Arrow" Fill="White" Height="11" Width="9.67"
  Data="M4.12,0 L9.67,5.47 L4.12,10.94 L0,10.88 L5.56,5.47 L0,0.06" />

使用移动和绘制命令与使用 PathGeometry

对于 Windows 运行时 XAML，移动和绘制命令将生成包含 Figures 属性值的单个 PathFigure 对象的 PathGeometry。 每个绘制命令都将在此单个 PathFigure 的 Segments 集合中生成一个 PathSegment 派生类，移动命令将更改 StartPoint，并且存在的关闭命令可将 IsClosed 设置为 true。 如果你在运行时检查 Data 值，则可以将此结构作为对象模型导航。

基本语法

移动和绘制命令的语法可总结如下：

  1. 以可选填充规则开始。 通常仅在不希望 EvenOdd 默认时指定它。 （稍后将详细介绍 EvenOdd。）
  2. 具体指定一个移动命令。
  3. 指定一个或多个绘制命令。
  4. 指定一个关闭命令。 你可以省略关闭命令，但是这会使你的图像处于打开状态（这不常见）。

此语法的一般规则如下：

  • 每个命令都由一个明确的字母表示。
  • 该字母可以大写，也可以小写。 按照我们的说明注意大小写。
  • 除关闭命令之外的每个命令通常都后跟一个或多个数字。
  • 如果命令中具有多个数字，则使用逗号或空格进行分隔。

[fillRule]moveCommanddrawCommand[drawCommand*][closeCommand]

许多绘制命令都使用你为其提供 x,y 值的点。 每当你看到 *points 占位符时，可以假设你为某个点的 x,y 值提供了两个十进制值。

如果结果清晰，空白区域通常可以忽略。 事实上，如果你对所有数字集（点和大小）使用逗号作为分隔符，则可以忽略所有空白区域。 例如，下面的用法是合法的：F1M0,58L2,56L6,60L13,51L15,53L6,64z。 但是包括命令之间的空白区域以获取清晰度是更为典型的用法。

不要将逗号用作十进制数字的小数点；命令字符串由 XAML 解释，并且不会说明特定于文化的数字格式约定，该约定与 en-us 当地使用的约定不同。

语法细节

填充规则

对于可选的填充规则，存在两个可能的值：F0 或 F1。 （F 始终大写。）F0 是默认值，它可生成 EvenOdd 填充行为，因此你通常无需指定它。 使用 F1 获取 Nonzero 填充行为。 这些填充值与 FillRule 枚举的值一致。

移动命令

指定新图形的起点。

语法
M startPoint
- 或 -
mstartPoint
术语 说明
startPoint 点
新图形的起点。

大写 M 指示 startPoint 是绝对坐标；小写 m 指示 startPoint 是上一个点的偏移或 (0,0)（如果没有上一个点）。

注意 在移动命令后指定多个点是合法的。 向这些点绘制一条直线，就像你指定了直线命令一样。 但是这不是建议的样式；请改为使用专门的直线命令。

绘制命令

绘制命令可由多个形状命令组成：线、横线、竖线、三次方贝塞尔曲线、二次方贝塞尔曲线、平滑三次方贝塞尔曲线、平滑二次方贝塞尔曲线和椭圆弧。

对于所有绘制命令，区分大小写。 大写字母指示绝对坐标，小写字母指示相对于上一个命令的坐标。

分段的控制点相对于前一段的端点。 当连续输入了同一类型的多个命令时，你可以忽略重复的命令输入。 例如，L 100,200 300,400 等效于 L 100,200 L 300,400。

直线命令

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

语法
LendPoint
- 或 -
lendPoint
术语 说明
endPoint 点
线条的终点。

横线命令

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

语法
H x
- 或 -
h x
术语 说明
x Double
线条终点的 x 坐标。

竖线命令

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

语法
V y
- 或 -
v y
术语 说明
y Double
直线终点的 y 坐标。

三次方贝塞尔曲线命令

通过使用两个指定的控制点（controlPoint1 和 controlPoint2）在当前点和指定的端点之间创建一条三次方贝塞尔曲线。 C 100,200 200,400 300,200 是有效曲线命令的示例。 使用 BezierSegment 对象定义 PathGeometry 对象的等效对象。

语法
C controlPoint1controlPoint2endPoint
- 或 -
c controlPoint1controlPoint2endPoint
术语 说明
controlPoint1 点
曲线的第一个控制点，它决定曲线的起始切线。
controlPoint2 点
曲线的第二个控制点，它决定曲线的结束切线。
endPoint 点
绘制曲线将通过的点。

二次方贝塞尔曲线命令

通过使用指定的控制点 (controlPoint) 在当前点和指定的端点之间创建一条二次方贝塞尔曲线。 q 100,200 300,200 是一个有效二次方贝塞尔曲线命令的示例。 使用 QuadraticBezierSegment 定义 PathGeometry 的等效对象。

语法
Q controlPoint endPoint
- 或 -
q controlPoint endPoint
术语 说明
controlPoint 点
曲线的控制点，它决定曲线的开始和结束切线。
endPoint 点
绘制曲线将通过的点。

平滑三次方贝塞尔曲线命令

在当前点和指定的端点之间创建一条三次方贝塞尔曲线。 假设第一控制点为相对当前点前一命令的第二控制点的反射。 如果没有上一个命令或者如果上一个命令不是三次方贝塞尔曲线命令或平滑三次方贝塞尔曲线命令，则假设第一个控制点与当前点一致。 第二个控制点（曲线末端的控制点）由 controlPoint2 指定。 例如，S 100,200 200,300 是有效的平滑三次方贝塞尔曲线命令。 此命令使用 BezierSegment 定义 PathGeometry 的等效对象，其中存在之前的曲线段。

语法
ScontrolPoint2endPoint
- 或 -
scontrolPoint2 endPoint
术语 说明
controlPoint2 点
曲线的控制点，它决定曲线的结束切线。
endPoint 点
绘制曲线将通过的点。

平滑二次方贝塞尔曲线命令

在当前点和指定的端点之间创建一条二次方贝塞尔曲线。 假设控制点为相对于当前点前一命令的控制点的反射。 如果没有上一个命令或者如果上一个命令不是二次方贝塞尔曲线命令或平滑二次方贝塞尔曲线命令，则该控制点与当前点一致。 此命令使用 QuadraticBezierSegment 定义 PathGeometry 的等效对象，其中存在之前的曲线段。

语法
TcontrolPointendPoint
- 或 -
tcontrolPointendPoint
术语 说明
controlPoint 点
曲线的控制点，决定曲线的起点和曲线的切线。
endPoint 点
绘制曲线将通过的点。

椭圆弧命令

在当前点和指定的终点之间创建一个椭圆弧。 使用 ArcSegment 定义 PathGeometry 的等效对象。

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

关闭命令

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

语法
Z
- 或 -
z

点语法

介绍了某个点的 x 坐标和 y 坐标。 另请参阅 Point。

语法
x,y
- 或 -
xy
术语 说明
x Double
该点的 x 坐标。
y Double
该点的 y 坐标。

其他说明

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

  • Infinity：表示 PositiveInfinity。
  • -Infinity：表示 NegativeInfinity。
  • NaN：表示 NaN。

你可以使用科学计数法，而不是使用小数或整数。 例如，+1.e17 是有效值。

用于生成移动和绘制命令的设计工具

在 Blend for Microsoft Visual Studio 2015 中使用笔工具和其他绘图工具通常会生成一个具有移动和绘制命令的 Path 对象。

你可能在某些控件部件中看到现有移动和绘制命令数据，这些部件已在控件的 Windows 运行时 XAML 默认模板中定义。 例如，某些控件将已定义数据的 PathIcon 用作移动和绘制命令。

为其他常用矢量图形设计工具提供了输出程序或插件，这些工具用于采用 XAML 格式输出矢量。 它们通常使用 Path.Data 的移动和绘制命令在布局容器中创建 Path 对象。 XAML 中可能存在多个 Path 元素，因此可以应用不同的画笔。 许多此类导出程序或插件最初是为 Windows Presentation Foundation (WPF) XAML 或 Silverlight 编写的，但 XAML 路径语法与 Windows 运行时 XAML 一致。 通常，你可以使用来自导出程序的 XAML 区块，并将其正确粘贴到 Windows 运行时 XAML 页面中。 （但是，如果 RadialGradientBrush 是已转换的 XAML 的一部分，你将无法使用它，因为 Windows 运行时 XAML 不支持该画笔。）