Path
路徑繪制組件,根據(jù)繪制路徑生成封閉的自定義形狀。
說明:
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
該組件從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。
子組件
無
接口
Path(value?: { width?: number | string; height?: number | string; commands?: string })
從API version 9開始,該接口支持在ArkTS卡片中使用。
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
width | number | string | 否 |
height | number | string | 否 |
commands | string | 否 | 路徑繪制的命令字符串 默認(rèn)值:''**說明:**異常值按照默認(rèn)值處理。 |
屬性
除支持[通用屬性]外,還支持以下屬性:
名稱 | 類型 | 默認(rèn)值 | 描述 |
---|---|---|---|
commands | string | '' | 路徑繪制的命令字符串,單位為px。像素單位轉(zhuǎn)換方法請(qǐng)參考[像素單位轉(zhuǎn)換]。 從API version 9開始,該接口支持在ArkTS卡片中使用。**說明:**異常值按照默認(rèn)值處理。 |
fill | [ResourceColor] | Color.Black | 設(shè)置填充區(qū)域顏色。 從API version 9開始,該接口支持在ArkTS卡片中使用。**說明:**異常值按照默認(rèn)值處理。 |
fillOpacity | number | string | [Resource] |
stroke | [ResourceColor] | - | 設(shè)置邊框顏色,不設(shè)置時(shí),默認(rèn)沒有邊框。 從API version 9開始,該接口支持在ArkTS卡片中使用。**說明:**異常值不會(huì)繪制邊框。 |
strokeDashArray | Array | [] | 設(shè)置線條間隙。 從API version 9開始,該接口支持在ArkTS卡片中使用。**說明:**異常值按照默認(rèn)值處理。 |
strokeDashOffset | number | string | 0 |
strokeLineCap | [LineCapStyle] | LineCapStyle.Butt | 設(shè)置線條端點(diǎn)繪制樣式。 從API version 9開始,該接口支持在ArkTS卡片中使用。 |
strokeLineJoin | [LineJoinStyle] | LineJoinStyle.Miter | 設(shè)置線條拐角繪制樣式。 從API version 9開始,該接口支持在ArkTS卡片中使用。 |
strokeMiterLimit | number | string | 4 |
strokeOpacity | number | string | [Resource] |
strokeWidth | Length | 1 | 設(shè)置線條寬度。 從API version 9開始,該接口支持在ArkTS卡片中使用。**說明:**該屬性若為string類型, 暫不支持百分比。 異常值按照默認(rèn)值處理。 |
antiAlias | boolean | true | 是否開啟抗鋸齒效果。 從API version 9開始,該接口支持在ArkTS卡片中使用。 |
commands支持的繪制命令如下:
命令 | 名稱 | 參數(shù) | 說明 |
---|---|---|---|
M | moveto | (x y) | 在給定的 (x, y) 坐標(biāo)處開始一個(gè)新的子路徑。例如,M 0 0 表示將(0, 0)點(diǎn)作為新子路徑的起始點(diǎn)。 |
L | lineto | (x y) | 從當(dāng)前點(diǎn)到給定的 (x, y) 坐標(biāo)畫一條線,該坐標(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)。如果沒有前一個(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)。 如果沒有前一個(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 | 通過將當(dāng)前路徑連接回當(dāng)前子路徑的初始點(diǎn)來關(guān)閉當(dāng)前子路徑。 |
例如: commands('M0 20 L50 50 L50 100 Z')定義了一個(gè)三角形,起始于位置(0,20),接著繪制點(diǎn)(0,20)到點(diǎn)(50,50)的直線,再繪制點(diǎn)(50,50)到點(diǎn)(50,100)的直線,最后繪制點(diǎn)(50,100)到(0,20)的直線關(guān)閉路徑,形成封閉三角形。
示例
`HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿`
// xxx.ets
@Entry
@Component
struct PathExample {
build() {
Column({ space: 10 }) {
Text('Straight line')
.fontSize(11)
.fontColor(0xCCCCCC)
.width('90%')
// 繪制一條長(zhǎng)600px,寬3vp的直線
Path()
.width('600px')
.height('10px')
.commands('M0 0 L600 0')
.stroke(Color.Black)
.strokeWidth(3)
Text('Straight line graph')
.fontSize(11)
.fontColor(0xCCCCCC)
.width('90%')
// 繪制直線圖形
Flex({ justifyContent: FlexAlign.SpaceBetween }) {
Path()
.width('210px')
.height('310px')
.commands('M100 0 L200 240 L0 240 Z')
.fillOpacity(0)
.stroke(Color.Black)
.strokeWidth(3)
Path()
.width('210px')
.height('310px')
.commands('M0 0 H200 V200 H0 Z')
.fillOpacity(0)
.stroke(Color.Black)
.strokeWidth(3)
Path()
.width('210px')
.height('310px')
.commands('M100 0 L0 100 L50 200 L150 200 L200 100 Z')
.fillOpacity(0)
.stroke(Color.Black)
.strokeWidth(3)
}.width('95%')
Text('Curve graphics').fontSize(11).fontColor(0xCCCCCC).width('90%')
// 繪制弧線圖形
Flex({ justifyContent: FlexAlign.SpaceBetween }) {
Path()
.width('250px')
.height('310px')
.commands("M0 300 S100 0 240 300 Z")
.fillOpacity(0)
.stroke(Color.Black)
.strokeWidth(3)
Path()
.width('210px')
.height('310px')
.commands('M0 150 C0 100 140 0 200 150 L100 300 Z')
.fillOpacity(0)
.stroke(Color.Black)
.strokeWidth(3)
Path()
.width('210px')
.height('310px')
.commands('M0 100 A30 20 20 0 0 200 100 Z')
.fillOpacity(0)
.stroke(Color.Black)
.strokeWidth(3)
}.width('95%')
}.width('100%')
.margin({ top: 5 })
}
}
審核編輯 黃宇
-
組件
+關(guān)注
關(guān)注
1文章
503瀏覽量
17784 -
鴻蒙
+關(guān)注
關(guān)注
57文章
2302瀏覽量
42689
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
評(píng)論