WPF学习笔记（3）：Path绘制命令zz

WPF的XAML提供了一系列功能强大、用法复杂的 mini-language 来描述可扩展应用程序标记语言 (XAML) 中的几何路径。如下所示：

XAML

<Canvas>
  <Path Stroke="Black" Fill="Gray"
    Data="M 10,100 C 10,300 300,-200 300,100" />
</Canvas>

Command

Name

Description

F i

FillRule

i=0:EvenOdd.

i=1:NonZero.

M x y

Move

Moveto (x, y).

m x y

Relative move

Moveto (x₀+x, y₀+y).

L x y

Line

Drawline to (x, y).

l x y

Relative line

Drawline to (x₀+x, y₀+y).

H x

Horizontal line

Drawline to (x, y₀).

h x

Relative horizontal line

Drawline to (x₀+x, y₀).

V y

Vertical line

Drawline to (x₀, y).

v y

Relative vertical line

Drawline to (x₀, y₀+y).

A x_r y_r a i j x y

Arc

Drawarc to (x, y) based on ellipse with radii (x_r,y_r) rotated a degrees.i=1:IsLargeArc. j=1: Clockwise.

a x_r y_r a i j x y

Relative arc

Drawarc to (x₀+x, y₀+y).

C x₁ y₁ x₂y₂x₃ y₃

CubicBézier

DrawBézier to (x₃, y₃) withcontrol points (x₁, y₁) and (x₂, y₂).

c x₁ y₁ x₂y₂x₃ y₃

Relative cubic Bézier

DrawBézier to (x₀+x₃,y₀+y₃) with control points (x₀+x₁, y₀+y₁) and (x₀+x₂,y₀+y₂).

S x₂ y₂ x₃ y₃

Smooth cubic Bézier

DrawBézier to (x₃, y₃) with reflected control point and (x₂, y₂).

s x₂ y₂ x₃y₃

Relative smooth cubic Bézier

DrawBézier to (x₀+x₃,y₀+y₃) with reflected control point and (x₀+x₂,y₀+y₂).

Q x₁ y₁ x₂y₂

Quadratic Bézier

Drawquadratic Bézier to (x₂, y₂)with control point (x₁, y₁).

q x₁ y₁ x₂y₂

Relative quadratic Bézier

Drawquadratic Bézier to (x₀+x₂,y₀+y₂) with control point(x₀+x₁, y₀+y₁).

Z

z

Closefigure

分隔符和空白

为简洁起见，下文中的语法部分显示的是单个空格，实际上在使用单个空格的地方也可以使用多个空格。

如果结果字符串比较明确，则无需使用逗号或空白将两个数字隔开。例如，2..3 解释为两个数字：“2.”和“.3”。同样，2-3 包含两个数字：“2”和“-3”。

命令前后的空格也不是必需的。

语法

XAML 路径语法由一个可选的 FillRule 值以及一个或多个图形说明组成。

路径 XAML 属性用法

<对象属性 ="[fillRule] figureDescription[ figureDescription]*" ... />

术语

说明

fillRule

FillRule

指定该路径使用 EvenOdd 还是 NonZero 填充规则值：

• F0 指定 EvenOdd 填充规则。

• F1 指定 Nonzero 填充规则。

如果省略此命令，则路径使用默认行为，即 EvenOdd。如果指定此命令，则必须将其置于最前面。

figureDescription

图形由移动命令、绘制命令和可选的关闭命令组成。

moveCommand drawCommands [ closeCommand ]

moveCommand

指定图形起点的移动命令。

drawCommands

一个或多个描绘图形内容的绘制命令。

closeCommand

可选的关闭命令，用于关闭图形。

移动命令

指定新图形的起点。

语法

M startPoint

- 或 -

m startPoint

术语

说明

startPoint

Point

图形的起点。

大写的 M 指示 startPoint 是绝对值；小写的 m 指示 startPoint 是相对于上一个点的偏移量，如果是 (0,0)，则表示不存在偏移。当您在 move 命令之后列出多个点时，即使您指定的是线条命令，也将绘制出连接这些点的线。

绘制命令

draw 命令可以由若干个形状命令组成。提供以下形状命令：直线、水平线、垂直线、三次方贝塞尔曲线、二次贝塞尔曲线、平滑的三次方贝塞尔曲线、平滑的二次贝塞尔曲线和椭圆弧线。

通过使用一个大写或小写字母输入各命令：其中大写字母表示绝对值，小写字母表示相对值。线段的控制点是相对于上一线段的终点而言的。依次输入多个同一类型的命令时，可以省略重复的命令项；例如，L 100,200 300,400 等同于 L 100,200 L 300,400。

直线命令

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

语法

L endPoint

- 或 -

l endPoint

术语

说明

endPoint

Point

直线的终点。

水平线命令

在当前点与指定的 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 是有效的曲线命令示例。

语法

C controlPoint1 controlPoint2 endPoint

- 或 -

c controlPoint1 controlPoint2 endPoint

术语

说明

controlPoint1

Point

曲线的第一个控制点，用于确定曲线的起始正切值。

controlPoint2

Point

曲线的第二个控制点，用于确定曲线的终止正切值。

endPoint

Point

曲线将绘制到的点。

二次贝塞尔曲线命令

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

语法

Q controlPoint endPoint

- 或 -

q controlPoint endPoint

术语

说明

controlPoint

Point

曲线的控制点，用于确定曲线的起始和终止正切值。

endPoint

Point

曲线将绘制到的点。

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

在当前点与指定的终点之间创建一条三次方贝塞尔曲线。第一个控制点假定为前一个命令的第二个控制点相对于当前点的反射。如果前一个命令不存在，或者前一个命令不是三次方贝塞尔曲线命令或平滑的三次方贝塞尔曲线命令，则假定第一个控制点就是当前点。第二个控制点，即曲线终端的控制点，由 controlPoint2 指定。例如，S 100,200 200,300 是一个有效的平滑三次方贝塞尔曲线命令。

语法

S controlPoint2 endPoint

- 或 -

s controlPoint2 endPoint

术语

说明

controlPoint2

Point

曲线的控制点，用于确定曲线的终止正切值。

endPoint

Point

曲线将绘制到的点。

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

在当前点与指定的终点之间创建一条二次贝塞尔曲线。控制点假定为前一个命令的控制点相对于当前点的反射。如果前一个命令不存在，或者前一个命令不是二次贝塞尔曲线命令或平滑的二次贝塞尔曲线命令，则此控制点就是当前点。

语法

T controlPoint endPoint

- 或 -

t controlPoint endPoint

术语

说明

controlPoint

Point

曲线的控制点，用于确定曲线的起始正切值。

endPoint

Point

曲线将绘制到的点。

椭圆弧线命令

在当前点与指定的终点之间创建一条椭圆弧线。

语法

A size rotationAngle isLargeArcFlag sweepDirectionFlag endPoint

- 或 -

a size rotationAngle isLargeArcFlag sweepDirectionFlag endPoint

术语

说明

大小

x, y pair

弧线的 x 轴半径和 y 轴半径。

rotationAngle

Double

椭圆的旋转度数。

isLargeArcFlag

如果弧线的角度应大于或等于 180 度，则设置为 1；否则设置为 0。

sweepDirectionFlag

如果弧线按照正角方向绘制，则设置为 1；否则设置为 0。

endPoint

Point

弧线将绘制到的点。

关闭命令

close 命令终止当前的图形并创建一条连接当前点和图形起点的线。此命令在图形的最后一个线段与第一个线段之间创建一条连线（转角）。

语法

Z

- 或 -

z

点语法

点语法描述点的 x 坐标和 y 坐标。

语法

x , y

- 或 -

x y

术语

说明

x

Double

点的 x 坐标。

y

Double

点的 y 坐标。

特殊值

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

值

说明

Infinity

表示正无穷大的 Double 值 (Double..::.PositiveInfinity)。

-Infinity

表示负无穷大的 Double 值 (Double..::.NegativeInfinity)。

NaN

表示 NaN Double 值 (Double..::.NaN)。

此外，您还可以使用科学计数法。例如，+1.e17 是有效值。