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

矩形繪制組件

2024-01-22 18:05 更新

矩形繪制組件。

說明

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

子組件

無

接口

Rect(value?: {width?: string | number,height?: string | number,radius?: string | number | Array<string | number>} |

{width?: string | number,height?: string | number,radiusWidth?: string | number,radiusHeight?: string | number})

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

參數(shù)：

參數(shù)名	參數(shù)類型	必填	參數(shù)描述
width	string \| number	否	寬度。說明：異常值按照默認(rèn)值處理。
height	string \| number	否	高度。說明：異常值按照默認(rèn)值處理。
radius	string \| number \| Array<string \| number>	否	圓角半徑，支持分別設(shè)置四個(gè)角的圓角度數(shù)。該屬性和radiusWidth/radiusHeight屬性效果類似，在組合使用時(shí)優(yōu)先于radiusWidth/radiusHeight生效說明：異常值按照默認(rèn)值處理。
radiusWidth	string \| number	否	圓角寬度。說明：異常值按照默認(rèn)值處理。
radiusHeight	string \| number	否	圓角高度。說明：異常值按照默認(rèn)值處理。

屬性

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

名稱	類型	默認(rèn)值	描述
radiusWidth	string \| number	0	圓角的寬度，僅設(shè)置寬時(shí)寬高一致。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認(rèn)值處理。
radiusHeight	string \| number	0	圓角的高度，僅設(shè)置高時(shí)寬高一致。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認(rèn)值處理。
radius	string \| number \| Array<string \| number>	0	圓角半徑大小。從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è)置邊框?qū)挾取?/p> 從API version 9開始，該接口支持在ArkTS卡片中使用。說明：該屬性若為string類型, 暫不支持百分比。異常值按照默認(rèn)值處理。
antiAlias	boolean	true	是否開啟抗鋸齒效果。從API version 9開始，該接口支持在ArkTS卡片中使用。說明：異常值按照默認(rèn)值處理。

示例


// xxx.ets
@Entry
@Component
struct RectExample {
  build() {
    Column({ space: 10 }) {
      Text('normal').fontSize(11).fontColor(0xCCCCCC).width('90%')
      // 繪制90% * 50的矩形
      Column({ space: 5 }) {
        Text('normal').fontSize(9).fontColor(0xCCCCCC).width('90%')
        // 繪制90% * 50矩形
        Rect({ width: '90%', height: 50 })
          .fill(Color.Pink)
        // 繪制90% * 50的矩形框
        Rect()
          .width('90%')
          .height(50)
          .fillOpacity(0)
          .stroke(Color.Red)
          .strokeWidth(3)

        Text('with rounded corners').fontSize(11).fontColor(0xCCCCCC).width('90%')
        // 繪制90% * 80的矩形, 圓角寬高分別為40、20
        Rect({ width: '90%', height: 80 })
          .radiusHeight(20)
          .radiusWidth(40)
          .fill(Color.Pink)
        // 繪制90% * 80的矩形, 圓角寬高為20
        Rect({ width: '90%', height: 80 })
          .radius(20)
          .fill(Color.Pink)
          .stroke(Color.Transparent)
      }.width('100%').margin({ top: 10 })
      // 繪制90% * 50矩形, 左上圓角寬高40,右上圓角寬高20,右下圓角寬高40,左下圓角寬高20
      Rect({ width: '90%', height: 80 })
        .radius([[40, 40], [20, 20], [40, 40], [20, 20]])
        .fill(Color.Pink)
    }.width('100%').margin({ top: 5 })
  }
}

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

← 路徑繪制組件

繪制組件的父組件 →

寫筆記

我要補(bǔ)充

矩形繪制組件

子組件

接口

屬性

示例

推薦文章

推薦教程

推薦課程