閱讀(565) 書簽贊(0) 我要糾錯

折線繪制組件

2024-01-22 18:03 更新

折線繪制組件。

說明

該組件從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。

子組件

無

接口

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

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

參數(shù)：

參數(shù)名	參數(shù)類型	必填	默認(rèn)值	參數(shù)描述
width	string \| number	否	0	寬度。說明：異常值按照默認(rèn)值處理。
height	string \| number	否	0	高度。說明：異常值按照默認(rèn)值處理。

參數(shù)名

參數(shù)類型

必填

默認(rèn)值

參數(shù)描述

width

string | number

否

寬度。

說明：

異常值按照默認(rèn)值處理。

height

string | number

否

高度。

說明：

異常值按照默認(rèn)值處理。

屬性

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

名稱	類型	默認(rèn)值	描述
points	Array<Point>	[]	折線經(jīng)過坐標(biāo)點(diǎn)列表。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認(rèn)值處理。
fill	ResourceColor	Color.Black	設(shè)置填充區(qū)域顏色。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認(rèn)值處理。
fillOpacity	number \| string \| Resource	1	設(shè)置填充區(qū)域透明度。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認(rèn)值處理。
stroke	ResourceColor	-	設(shè)置邊框顏色，不設(shè)置時(shí)，默認(rèn)沒有邊框線條。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值不會繪制邊框線條。
strokeDashArray	Array<Length>	[]	設(shè)置線條間隙。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認(rèn)值處理。
strokeDashOffset	number \| string	0	線條繪制起點(diǎn)的偏移量。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認(rèn)值處理。
strokeLineCap	LineCapStyle	LineCapStyle.Butt	設(shè)置線條端點(diǎn)繪制樣式。從API version 9開始，該接口支持在ArkTS卡片中使用。
strokeLineJoin	LineJoinStyle	LineJoinStyle.Miter	設(shè)置線條拐角繪制樣式。從API version 9開始，該接口支持在ArkTS卡片中使用。
strokeMiterLimit	number \| string	4	設(shè)置斜接長度與邊框?qū)挾缺戎档臉O限值。斜接長度表示外邊框外邊交點(diǎn)到內(nèi)邊交點(diǎn)的距離，邊框?qū)挾燃磗trokeWidth屬性的值。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：該屬性取值需在strokeLineJoin屬性取值LineJoinStyle.Miter時(shí)生效。該屬性的合法值范圍應(yīng)當(dāng)大于等于1.0，當(dāng)取值范圍在[0,1)時(shí)按1.0處理，其余異常值按默認(rèn)值處理。
strokeOpacity	number \| string \| Resource	1	設(shè)置線條透明度。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：該屬性的取值范圍是[0.0, 1.0]，若給定值小于0.0，則取值為0.0；若給定值大于1.0，則取值為1.0，其余異常值按1.0處理。
strokeWidth	Length	1	設(shè)置線條寬度。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：該屬性若為string類型, 暫不支持百分比。異常值按照默認(rèn)值處理。
antiAlias	boolean	true	是否開啟抗鋸齒效果。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認(rèn)值處理。

Point

點(diǎn)坐標(biāo)類型。

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

名稱	類型定義	描述
Point	[number, number]	第一個參數(shù)為x軸坐標(biāo)，第二個參數(shù)為y軸坐標(biāo)（相對坐標(biāo)）。

示例


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

以上內(nèi)容是否對您有幫助：

← 直線繪制組件

多邊形繪制組件 →

寫筆記

我要補(bǔ)充

折線繪制組件

子組件

接口

屬性

Point

示例

推薦文章

推薦教程

推薦課程