[UWP]实用的Shape指南

在uwp ui系统中，使用shape是绘制2d图形最简单的方式，小到图标，大到图表都用到shape的派生类，可以说有举足轻重的地位。幸运的是从silverlight以来shape基本没有什么大改动，简直是uwp中的一股清流。

上图来自Pro Silverlight 5 in C#，可见Silverlight中的Shape和UWP的Shape基本架构一致。Shape的API从WPF以来就几乎没变，对熟悉WPF/Silverlight的开发者来说几乎是零学习成本。

1. Ellipse(圆形)

Ellipse没有在Shape的基础上增加任何属性，是Shape的派生类中最简单的一个。

1.1 Fill、Stroke与StrokeThickness

public Brush Fill { get; set; }

、

public Brush Stroke { get; set; }

与

public System.Double StrokeThickness { get; set; }

是Shape中最常用的三个属性，分别用于设置Shape的填充颜色、边框颜色、边框宽度。改变StrokeThickness并不会改变形状的大小。

代码语言：javascript代码运行次数：0运行复制

<Ellipse  Height="100"          Width="100"          Fill="#FF7E9EC0"          Stroke="#FFFF0EC4"          StrokeThickness="5"          Margin="10" />

1.2 Stretch

public Stretch Stretch { get; set; }

用于确定形状如何填充可用的区域。Stretch的所有枚举值如下：

None: 形状不被拉伸。Fill: 形状拉伸其宽度和高度，从而可以正好适应其容器。Uniform: 按比例改变形状的宽度和高度，直至形状到达容器板边缘。UniformToFill: 按比例改变形状的宽度和高度，直到形状填满了整个可用控件的高度和宽度。

效果如下

代码语言：javascript代码运行次数：0运行复制

<StackPanel Orientation="Horizontal">    <Ellipse Fill="#FF7E9EC0"             Stroke="#FFFF0EC4"             StrokeThickness="5"             Height="50"             Width="100"             Stretch="Fill" />    <Ellipse Fill="#FF7E9EC0"             Stroke="#FFFF0EC4"             StrokeThickness="5"             Height="50"             Width="100"             Stretch="None" />    <Ellipse Fill="#FF7E9EC0"             Stroke="#FFFF0EC4"             StrokeThickness="5"             Height="50"             Width="100"             Stretch="Uniform" />    <Ellipse Fill="#FF7E9EC0"             Stroke="#FFFF0EC4"             StrokeThickness="5"             Height="50"             Width="100"             Stretch="UniformToFill" /></StackPanel>

1.3 StrokeDashArray

public DoubleCollection StrokeDashArray { get; set; }用于将边框变成虚线。StrokeDashArray的值是一个double类型的有序集合，集合中的值指虚线中每一段的长度，长度单位是边框值的宽度。例如以下圆形：

代码语言：javascript代码运行次数：0运行复制

<Ellipse StrokeDashArray="1,2,3"         Stroke="#FFFF0EC4"         StrokeThickness="10"         Height="200"         Width="200" />

边框宽度为10，虚线的第一段是长度为10的实线，第二段为长度为20的空白，第三段为长度为30的实线，然后如此循环直到结束。

自从开始WPF工作以来，我一直将StrokeDashArray的值设为一个好看又好记的值：4 2,the answer to life, the universe, and everything。

代码语言：javascript代码运行次数：0运行复制

<Ellipse StrokeDashArray="4 2"         Stroke="#FFFF0EC4"         StrokeThickness="3"         Height="200"         Width="200" />

1.4 StrokeDashCap

public PenLineCap StrokeDashCap { get; set; }

表示虚线中实线两端的边缘轮廓。PenLineCap的枚举值如下：

Flat: 一个未超出直线上最后一点的线帽。 等同于无线帽。Square: 一个高度等于直线粗细、长度等于直线粗细一半的矩形。Round: 一个直径等于直线粗细的半圆形。Triangle: 一个底边长度等于直线粗细的等腰直角三角形。代码语言：javascript代码运行次数：0运行复制

<Grid Margin="10,10"      Width="200"      Height="10"      Background="Gray">    <Line Stretch="Fill"          Stroke="Red"          StrokeThickness="10.5"          X2="1"          StrokeEndLineCap="Flat" /></Grid><TextBlock Text="Flat"           Grid.Column="1"           VerticalAlignment="Center" /><Grid Width="200"      Margin="10,10"      Height="10"      Background="Gray"      Grid.Row="1">    <Line Stretch="Fill"          Stroke="Red"          StrokeThickness="10"          X2="1"          StrokeEndLineCap="Round" /></Grid><TextBlock Text="Round"           Grid.Row="1"           Grid.Column="1"           VerticalAlignment="Center" /><Grid Width="200"      Margin="10,10"      Height="10"      Background="Gray"      Grid.Row="2">    <Line Stretch="Fill"          Stroke="Red"          StrokeThickness="10"          X2="1"          StrokeEndLineCap="Square" /></Grid><TextBlock Text="Square"           Grid.Row="2"           Grid.Column="1"           VerticalAlignment="Center" /><Grid Width="200"      Margin="10,10"      Height="10"      Background="Gray"      Grid.Row="3">    <Line Stretch="Fill"          Stroke="Red"          StrokeThickness="10"          X2="1"          StrokeEndLineCap="Triangle" /></Grid><TextBlock Text="Triangle"           Grid.Row="3"           Grid.Column="1"           VerticalAlignment="Center" />

1.5 StrokeDashOffset

public System.Double StrokeDashOffset { get; set; }用于指定虚线开始的位置。

2. Rectangle(矩形)

Rectangle 只比Shape多了RadiusX和RadiusY两个属性。

2.1 RadiusX和RadiusY

public System.Double RadiusX { get; set; }和public System.Double RadiusY { get; set; }分别用于指定用于使矩形的角变圆的椭圆的x轴和 y轴半径。

如下面这个例子，可以看到

 RadiusX="50" RadiusY="20"

的Rectangle的圆角和

Width="100" Height="40"

的Ellipse(x轴半径50，y轴半径20)完全重合在一起。

代码语言：javascript代码运行次数：0运行复制

<Rectangle  Height="100"            Width="100"            Fill="#FF7E9EC0"            Stroke="#FFFF0EC4"            StrokeThickness="5"            RadiusX="50"            RadiusY="20" /><Ellipse HorizontalAlignment="Left"         VerticalAlignment="Top"         StrokeThickness="5"         Stroke="Yellow"         Fill="Red"         Width="100"         Height="40"         Opacity="0.5" />

2.2 StrokeLineJoin和StrokeMiterLimit

public PenLineJoin StrokeLineJoin { get; set; }

和

public System.Double StrokeMiterLimit { get; set; }

确定形状拐角处的形状。这两个属性都是Shape的属性，但对Ellipse和Line这两个没有拐角的形状不起作用。

3. Line(直线)

Line表示从第一个点(X1,Y1)到第二个点(X2,Y2)的一条直线。

3.1 X1,Y1,X2,Y2

这四个属性确定了Line的起点和终点。

除了使用绝对值定位Line的位置，还可以使用相对定位。

代码语言：javascript代码运行次数：0运行复制

<Line Stretch="Fill"      X1="0"      X2="1"      StrokeDashArray="4 2"      Stroke="BlueViolet"      StrokeThickness="1" />

3.2 StrokeStartLineCap与StrokeEndLineCap

public PenLineCap StrokeStartLineCap { get; set; }

和

public PenLineCap StrokeEndLineCap { get; set; }

决定直线开始端和结束端的轮廓。这两个属性都是Shape的属性，但只影响Line、Polyline和Path，对Rectangle这类没有开始和结束端的形状没有影响。

4. Polygon(多边形)和Polyline(折线)

这两个形状具有相同的属性，外观也相似。区别只是如果Points的最后一个点和第一个点不一样，Polygon会自动将这两个点连接到一起。

4.1 Points

public PointCollection Points { get; set; }

用于设置Polygon和Polyline的顶点。

代码语言：javascript代码运行次数：0运行复制

<Polygon Points="15,200 68,70 110,200 0,125 135,125"         Fill="Red"         Stroke="Blue"         StrokeThickness="4"         Stretch="Fill"         Height="100"         Width="100" /><Polyline Points="15,200 68,70 110,200 0,125 135,125"          Fill="Red"          Stroke="Blue"          StrokeThickness="4"          Stretch="Fill"          Height="100"          Width="100"          Margin="20,0,0,0" />

4.2 FillRule

public FillRule FillRule { get; set; }

指定如何确定形状的内部填充。默认值是EvenOdd，如果设置成Nonzero，效果如下：

5 Path(路径)

Path是功能最强大的形状，它基本上由上面的其它形状组成并且可以替代它们中的任何一个。只是Path使用起来也比较复杂，只有在图表和少量场景用到，很多时候比起构造复杂的Path还不如用直接用图片。

5.1 Data

public Geometry Data { get; set; }

属性指定要绘制形状的Geometry。Geometry 定义几何图形并且定义了坐标和尺寸等细节 ，由Path绘制到屏幕。UWP中的Geometry包含以下几个：

EllipseGeometry: 表示圆或椭圆的几何图形。LineGeometry: 表示线条的几何图形。PathGeometry: 表示一个可能由弧、曲线、椭圆、直线和矩形组成的基于矢量的复杂形状。RectangleGeometry: 描述二维矩形这一几何图形。

除此之外，还可以使用由多个Geometry组成的GeometryGroup构造组合形状。

5.2 PathGeometry

在所有Geometry中PathGeometry是功能最强大的，唯一的缺点是太多复杂。它使用

public PathFigureCollection Figures { get; set; }

描述包含的图形内容，PathFigure由PathSegment的派生类描述，包括：

ArcSegment: 表示两点之间的一条椭圆弧。BezierSegment: 表示在两个点之间绘制的一条三次贝塞尔曲线。LineSegment: 表示在两个点之间绘制的一条线，它可能是 PathFigure 在 Path 数据内的一部分。PolyBezierSegment: 表示一条或多条三次方贝塞尔曲线。PolyLineSegment: 表示由 Point 集合定义的一组线段，每个 Point 指定一个线段的终点。PolyQuadraticBezierSegment: 表示一系列二次贝塞尔线段。QuadraticBezierSegment: 在 PathFigure 中的两点之间创建二次贝塞尔曲线。

下面是一个Path的官方示例，同时使用了各种Geometry及部分PathSegment：

代码语言：javascript代码运行次数：0运行复制

<Path Stroke="Black"       Margin="10"      StrokeThickness="1"      Fill="#CCCCFF">    <Path.Data>        <GeometryGroup>            <RectangleGeometry Rect="50,5 100,10" />            <RectangleGeometry Rect="5,5 95,180" />            <EllipseGeometry Center="100, 100"                             RadiusX="20"                             RadiusY="30" />            <RectangleGeometry Rect="50,175 100,10" />            <PathGeometry>                <PathGeometry.Figures>                    <PathFigureCollection>                        <PathFigure IsClosed="true"                                    StartPoint="50,50">                            <PathFigure.Segments>                                <PathSegmentCollection>                                    <BezierSegment Point1="75,300"                                                   Point2="125,100"                                                   Point3="150,50" />                                    <BezierSegment Point1="125,300"                                                   Point2="75,100"                                                   Point3="50,50" />                                </PathSegmentCollection>                            </PathFigure.Segments>                        </PathFigure>                    </PathFigureCollection>                </PathGeometry.Figures>            </PathGeometry>        </GeometryGroup>    </Path.Data></Path>

5.3 图形微语言(geometry mini-language)

Path的XAML虽然具备很高的可读性，但在存储上不具优势。所以UWP提供了一种替代语法：图形微语言。图形微语言使用一组简单的字符串描述Path的图形，一般来说不需要学习它的语法，因为通常它是由工具生成的。

代码语言：javascript代码运行次数：0运行复制

<Path Stroke="DarkGoldenRod"       StrokeThickness="3"      Data="M 100,200 C 100,25 400,350 400,175 H 280" />

5.4 使用Blend

通常用一个Path代替多个Shape不止更好管理，用户界面的性能也会更好。Blend里面提供了针对Shape的功能，可以对多个Shape进行合并或转换为路劲。

6. Shape各项属性比较

下面表格列出了Shape的各项属性，标记为“×”的属性代码这个属性对这个形状无效。

7. ViewBox

ViewBox是拉伸或缩放单个子元素的容器，最常用来搭配Shape（或文字）使用，因为Shape是矢量图形，放大后不会失真。

ViewBox有以下三个属性：

Child: 获取或设置 Viewbox 元素的单一子元素。Stretch: 获取或设置确定内容如何适合可用空间的 Stretch 模式。StretchDirection: 获取或设置确定缩放如何应用于 Viewbox 内容的 StretchDirection。代码语言：javascript代码运行次数：0运行复制

<StackPanel Orientation="Horizontal">    <Canvas Width="30" Height="30">        <Rectangle Stroke="Red"                   StrokeThickness="1"                   Height="20"                   Width="20" />        <Rectangle Stroke="Green"                   StrokeThickness="1"                   Height="20"                   Width="20"                   Canvas.Left="10"                   Canvas.Top="10" />    </Canvas>    <Viewbox Height="100"              Width="100"              Margin="30,0,0,0"             Stretch="Uniform">        <Canvas Height="30" Width="30">            <Rectangle Stroke="Red"                       StrokeThickness="1"                       Height="20"                       Width="20" />            <Rectangle Stroke="Green"                       StrokeThickness="1"                       Height="20"                       Width="20"                       Canvas.Left="10"                       Canvas.Top="10" />        </Canvas>    </Viewbox></StackPanel>

8. 结语

系统地学过Shape相关知识只在很多年前刚开始学WPF/Silverlight时做过，平时除了Rectangle和Line其他的Shape好少会用到，所以即使有多年经验对Shape的很多知识点还是有点陌生，这次趁学习UWP的机会复习一下。

但因为很多知识点平时就很少会用到，后面越写越腻味。

9. 参考

绘制形状 Windows.UI.Xaml.Shapes 命名空间 Windows.UI.Xaml.Media 命名空间