Line

Browse sample.浏览示例

.NET Multi-platform App UI (.NET MAUI) Line 类派生自 Shape 类,可用于绘制直线。 有关 Shape 类从 Line 类继承的属性的信息,请参阅形状

Line 定义以下属性:

  • X1,类型为 double,指示直线起点的 x 坐标。 此属性的默认值为 0.0。
  • Y1,类型为 double,指示直线起点的 y 坐标。 此属性的默认值为 0.0。
  • X2,类型为 double,指示直线终点的 x 坐标。 此属性的默认值为 0.0。
  • Y2,类型为 double,指示直线终点的 y 坐标。 此属性的默认值为 0.0。

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

有关控制如何绘制直线终点的信息,请参阅控制直线终点

创建直线

要绘制直线,请创建一个 Line 对象,并将其 X1Y1 属性设置为起点,将其 X2Y2 属性设置为终点。 此外,将其 Stroke 属性设置为 Brush 派生对象,因为没有描边的直线是不可见的。 有关 Brush 对象的详细信息,请参阅画笔

注意

设置 LineFill 属性没有任何作用,因为直线没有内部。

以下 XAML 示例演示如何绘制直线:

<Line X1="40"
      Y1="0"
      X2="0"
      Y2="120"
      Stroke="Red" />

在此示例中,从 (40,0) 到 (0,120) 绘制了红色对角线:

Diagonal line.

由于 X1Y1X2Y2 属性的默认值为 0,因此可以使用最少的语法绘制一些直线:

<Line Stroke="Red"
      X2="200" />

在此示例中,定义了长度为 200 个与设备无关单位的水平线。 由于其他属性默认为 0,因此会绘制一条从 (0,0) 到 (200,0) 的直线。

以下 XAML 示例演示如何绘制虚线:

<Line X1="40"
      Y1="0"
      X2="0"
      Y2="120"
      Stroke="DarkBlue"
      StrokeDashArray="1,1"
      StrokeDashOffset="6" />

在此示例中,从 (40,0) 到 (0,120) 绘制了深蓝色虚线:

Dashed line.

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