通过

折线

  • 项目

Browse sample.浏览示例

.NET Multi-platform App UI (.NET MAUI) Polyline 类派生自 Shape 类，可用于绘制一系列连接的直线。 折线类似于多边形，只是折线的最后一个点未连接到第一个点。 有关 Polyline 类从 Shape 类继承的属性的信息，请参阅形状。

Polyline 定义以下属性:

  • Points，类型为 PointCollection，是描述折线顶点的 Point 结构的集合。
  • FillRule，类型为 FillRule，指定如何组合折线中的相交区域。 此属性的默认值为 FillRule.EvenOdd。

这些属性由 BindableProperty 对象提供支持；也就是说，它们可以作为数据绑定的目标，并能进行样式设置。

PointsCollection 类型是 Point 对象的 ObservableCollection。 Point 结构定义类型为 double 的 X 和 Y 属性，这些属性表示二维空间中的 x 坐标和 y 坐标对。 因此，应将 Points 属性设置为描述折线顶点的 x 坐标和 y 坐标对的列表，由单个逗号和/或一个或多个空格分隔。 例如，“40,10 70,80”和“40 10, 70 80”都是有效的。

有关 FillRule 枚举的更多信息，请参阅填充规则。

创建折线

若要绘制折线，需创建 Polyline 对象，并将其 Points 属性设置为形状的顶点。 若要为折线提供轮廓，需将其 Stroke 属性设置为 Brush 派生对象。 StrokeThickness 属性指定折线轮廓的粗细。 有关 Brush 对象的详细信息，请参阅画笔。

重要

如果将 Polyline 的 Fill 属性设置为 Brush 派生对象，则绘制折线的内部空间，即使起点和终点不相交也是如此。

以下 XAML 示例展示了如何绘制折线：

<Polyline Points="0,0 10,30 15,0 18,60 23,30 35,30 40,0 43,60 48,30 100,30"
          Stroke="Red" />

在此示例中，绘制了红色折线：

Polyline.

以下 XAML 示例展示了如何绘制虚线折线：

<Polyline Points="0,0 10,30 15,0 18,60 23,30 35,30 40,0 43,60 48,30 100,30"
          Stroke="Red"
          StrokeThickness="2"
          StrokeDashArray="1,1"
          StrokeDashOffset="6" />

在此示例中，折线为虚线：

Dashed polyline.

有关绘制虚线折线的详细信息，请参阅绘制虚线形状。

以下 XAML 示例展示了使用默认填充规则的折线：

<Polyline Points="0 48, 0 144, 96 150, 100 0, 192 0, 192 96, 50 96, 48 192, 150 200 144 48"
          Fill="Blue"
          Stroke="Red"
          StrokeThickness="3" />

在此示例中，使用了 EvenOdd 填充规则来确定折线的填充行为。

EvenOdd polyline.

以下 XAML 示例展示了使用 Nonzero 填充规则的折线：

<Polyline Points="0 48, 0 144, 96 150, 100 0, 192 0, 192 96, 50 96, 48 192, 150 200 144 48"
          Fill="Black"
          FillRule="Nonzero"
          Stroke="Yellow"
          StrokeThickness="3" />

Nonzero polyline.

在此示例中，使用了 Nonzero 填充规则来确定折线的填充行为。