鴻蒙ArkTS媒體組件：Polyline

Polyline

折線繪制組件。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
該組件從API Version 7開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

子組件

無

接口

Polyline(value?: {width?: string | number, height?: string | number})

從API version 9開始，該接口支持在ArkTS卡片中使用。

參數：

參數名	參數類型	必填	默認值	參數描述
width	string	number	否	0
height	string	number	否	0

屬性

除支持[通用屬性]外，還支持以下屬性：

名稱	類型	默認值	描述
points	Array	[]	折線經過坐標點列表。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認值處理。
fill	[ResourceColor]	Color.Black	設置填充區域顏色。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認值處理。
fillOpacity	number	string	[Resource]
stroke	[ResourceColor]	-	設置邊框顏色，不設置時，默認沒有邊框線條。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值不會繪制邊框線條。
strokeDashArray	Array	[]	設置線條間隙。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認值處理。
strokeDashOffset	number	string	0
strokeLineCap	[LineCapStyle]	LineCapStyle.Butt	設置線條端點繪制樣式。從API version 9開始，該接口支持在ArkTS卡片中使用。
strokeLineJoin	[LineJoinStyle]	LineJoinStyle.Miter	設置線條拐角繪制樣式。從API version 9開始，該接口支持在ArkTS卡片中使用。
strokeMiterLimit	number	string	4
strokeOpacity	number	string	[Resource]
strokeWidth	Length	1	設置線條寬度。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：該屬性若為string類型, 暫不支持百分比。異常值按照默認值處理。
antiAlias	boolean	true	是否開啟抗鋸齒效果。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認值處理。

Point

點坐標類型。

從API version 9開始，該接口支持在ArkTS卡片中使用。

名稱	類型定義	描述`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
Point	[number, number]	第一個參數為x軸坐標，第二個參數為y軸坐標（相對坐標）。

QQ截圖20240705211318.png

示例

// xxx.ets
@Entry
@Component
struct PolylineExample {
  build() {
    Column({ space: 10 }) {
      // 在 100 * 100 的矩形框中繪制一段折線，起點(0, 0)，經過(20,60)，到達終點(100, 100)
      Polyline({ width: 100, height: 100 })
        .points([[0, 0], [20, 60], [100, 100]])
        .fillOpacity(0)
        .stroke(Color.Blue)
        .strokeWidth(3)
      // 在 100 * 100 的矩形框中繪制一段折線，起點(20, 0)，經過(0,100)，到達終點(100, 90)
      Polyline()
        .width(100)
        .height(100)
        .fillOpacity(0)
        .stroke(Color.Red)
        .strokeWidth(8)
        .points([[20, 0], [0, 100], [100, 90]])
          // 設置折線拐角處為圓弧
        .strokeLineJoin(LineJoinStyle.Round)
          // 設置折線兩端為半圓
        .strokeLineCap(LineCapStyle.Round)
    }.width('100%')
  }
}