閱讀(594) 書簽贊(0) 我要糾錯(cuò)

多邊形繪制組件

2024-01-22 18:04 更新

多邊形繪制組件。

說(shuō)明

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

子組件

無(wú)

接口

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

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

參數(shù)：

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

參數(shù)名

參數(shù)類型

必填

默認(rèn)值

參數(shù)描述

width

string | number

否

寬度。

說(shuō)明：

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

height

string | number

否

高度。

說(shuō)明：

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

屬性

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

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

Point

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

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

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

示例


// xxx.ets
@Entry
@Component
struct PolygonExample {
  build() {
    Column({ space: 10 }) {
      // 在 100 * 100 的矩形框中繪制一個(gè)三角形，起點(diǎn)(0, 0)，經(jīng)過(50, 100)，終點(diǎn)(100, 0)
      Polygon({ width: 100, height: 100 })
        .points([[0, 0], [50, 100], [100, 0]])
        .fill(Color.Green)
      // 在 100 * 100 的矩形框中繪制一個(gè)四邊形，起點(diǎn)(0, 0)，經(jīng)過(0, 100)和(100, 100)，終點(diǎn)(100, 0)
      Polygon().width(100).height(100)
        .points([[0, 0], [0, 100], [100, 100], [100, 0]])
        .fillOpacity(0)
        .strokeWidth(5)
        .stroke(Color.Blue)
      // 在 100 * 100 的矩形框中繪制一個(gè)五邊形，起點(diǎn)(50, 0)，依次經(jīng)過(0, 50)、(20, 100)和(80, 100)，終點(diǎn)(100, 50)
      Polygon().width(100).height(100)
        .points([[50, 0], [0, 50], [20, 100], [80, 100], [100, 50]])
        .fill(Color.Red)
        .fillOpacity(0.6)
    }.width('100%').margin({ top: 10 })
  }
}

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

← 折線繪制組件

路徑繪制組件 →

寫筆記

我要補(bǔ)充

多邊形繪制組件

子組件

接口

屬性

Point

示例

推薦文章

推薦教程

推薦課程