路徑繪制組件

width

number | string

否

路徑所在矩形的寬度

默認(rèn)值：0

說(shuō)明：

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

height

number | string

否

路徑所在矩形的高度

默認(rèn)值：0

說(shuō)明：

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

commands

string

否

路徑繪制的命令字符串

默認(rèn)值：''

說(shuō)明：

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

commands

string

''

路徑繪制的命令字符串，單位為px。像素單位轉(zhuǎn)換方法請(qǐng)參考像素單位轉(zhuǎn)換。

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

說(shuō)明：

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

fill

ResourceColor

Color.Black

設(shè)置填充區(qū)域顏色。

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

說(shuō)明：

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

fillOpacity

number | string | Resource

1

設(shè)置填充區(qū)域透明度。

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

說(shuō)明：

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

stroke

ResourceColor

-

設(shè)置邊框顏色，不設(shè)置時(shí)，默認(rèn)沒(méi)有邊框。

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

說(shuō)明：

異常值不會(huì)繪制邊框。

strokeDashArray

Array<Length>

[]

設(shè)置線條間隙。

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

說(shuō)明：

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

strokeDashOffset

number | string

0

線條繪制起點(diǎn)的偏移量。

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

說(shuō)明：

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

strokeLineCap

LineCapStyle

LineCapStyle.Butt

設(shè)置線條端點(diǎn)繪制樣式。

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

strokeLineJoin

LineJoinStyle

LineJoinStyle.Miter

設(shè)置線條拐角繪制樣式。

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

strokeMiterLimit

number | string

4

設(shè)置斜接長(zhǎng)度與邊框?qū)挾缺戎档臉O限值。斜接長(zhǎng)度表示外邊框外邊交點(diǎn)到內(nèi)邊交點(diǎn)的距離，邊框?qū)挾燃磗trokeWidth屬性的值。

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

說(shuō)明：

該屬性取值需在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開(kāi)始，該接口支持在ArkTS卡片中使用。

說(shuō)明：

該屬性的取值范圍是[0.0, 1.0]，若給定值小于0.0，則取值為0.0；若給定值大于1.0，則取值為1.0，其余異常值按1.0處理 。

strokeWidth

Length

1

設(shè)置線條寬度。

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

說(shuō)明：

該屬性若為string類型, 暫不支持百分比。

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

antiAlias

boolean

true

是否開(kāi)啟抗鋸齒效果。

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

M

moveto

（x y）

在給定的 (x, y) 坐標(biāo)處開(kāi)始一個(gè)新的子路徑。例如，M 0 0 表示將（0, 0）點(diǎn)作為新子路徑的起始點(diǎn)。

L

lineto

（x y）

從當(dāng)前點(diǎn)到給定的 (x, y) 坐標(biāo)畫(huà)一條線，該坐標(biāo)成為新的當(dāng)前點(diǎn)。例如，L 50 50 表示繪制當(dāng)前點(diǎn)到（50, 50）點(diǎn)的直線，并將（50, 50）點(diǎn)作為新子路徑的起始點(diǎn)。

H

horizontal lineto

x

從當(dāng)前點(diǎn)繪制一條水平線，等效于將y坐標(biāo)指定為0的L命令。例如，H 50 表示繪制當(dāng)前點(diǎn)到（50, 0）點(diǎn)的直線，并將（50, 0）點(diǎn)作為新子路徑的起始點(diǎn)。

V

vertical lineto

y

從當(dāng)前點(diǎn)繪制一條垂直線，等效于將x坐標(biāo)指定為0的L命令。例如，V 50 表示繪制當(dāng)前點(diǎn)到（0, 50）點(diǎn)的直線，并將（0, 50）點(diǎn)作為新子路徑的起始點(diǎn)。

C

curveto

(x1 y1 x2 y2 x y)

使用 (x1, y1) 作為曲線起點(diǎn)的控制點(diǎn)， (x2, y2) 作為曲線終點(diǎn)的控制點(diǎn)，從當(dāng)前點(diǎn)到 (x, y) 繪制三次貝塞爾曲線。例如，C100 100 250 100 250 200 表示繪制當(dāng)前點(diǎn)到（250, 200）點(diǎn)的三次貝塞爾曲線，并將（250, 200）點(diǎn)作為新子路徑的起始點(diǎn)。

S

smooth curveto

(x2 y2 x y)

(x2, y2) 作為曲線終點(diǎn)的控制點(diǎn)，繪制從當(dāng)前點(diǎn)到 (x, y) 繪制三次貝塞爾曲線。若前一個(gè)命令是C或S，則起點(diǎn)控制點(diǎn)是上一個(gè)命令的終點(diǎn)控制點(diǎn)相對(duì)于起點(diǎn)的映射。 例如，C100 100 250 100 250 200 S400 300 400 200第二段貝塞爾曲線的起點(diǎn)控制點(diǎn)為（250, 300）。如果沒(méi)有前一個(gè)命令或者前一個(gè)命令不是 C或S，則第一個(gè)控制點(diǎn)與當(dāng)前點(diǎn)重合。

Q

quadratic Belzier curve

(x1 y1 x y)

使用 (x1, y1) 作為控制點(diǎn)，從當(dāng)前點(diǎn)到 (x, y) 繪制二次貝塞爾曲線。例如，Q400 50 600 300 表示繪制當(dāng)前點(diǎn)到（600, 300）點(diǎn)的二次貝塞爾曲線，并將（600, 300）點(diǎn)作為新子路徑的起始點(diǎn)。

T

smooth quadratic Belzier curveto

(x y)

繪制從當(dāng)前點(diǎn)到 (x, y) 繪制二次貝塞爾曲線。若前一個(gè)命令是Q或T，則控制點(diǎn)是上一個(gè)命令的終點(diǎn)控制點(diǎn)相對(duì)于起點(diǎn)的映射。 例如，Q400 50 600 300 T1000 300第二段貝塞爾曲線的控制點(diǎn)為（800, 350）。 如果沒(méi)有前一個(gè)命令或者前一個(gè)命令不是 Q或T，則第一個(gè)控制點(diǎn)與當(dāng)前點(diǎn)重合。

A

elliptical Arc

(rx ry x-axis-rotation large-arc-flag sweep-flag x y)

從當(dāng)前點(diǎn)到 (x, y) 繪制一條橢圓弧。橢圓的大小和方向由兩個(gè)半徑 (rx, ry) 和x-axis-rotation定義，指示整個(gè)橢圓相對(duì)于當(dāng)前坐標(biāo)系如何旋轉(zhuǎn)（以度為單位）。 large-arc-flag 和 sweep-flag確定弧的繪制方式。

Z

closepath

none

通過(guò)將當(dāng)前路徑連接回當(dāng)前子路徑的初始點(diǎn)來(lái)關(guān)閉當(dāng)前子路徑。