椭圆绘制组件

2024-01-22 18:03 更新

椭圆绘制组件。

说明

该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

子组件

接口

Ellipse(options?: {width?: string | number, height?: string | number})

从API version 9开始,该接口支持在ArkTS卡片中使用。

参数:

参数名

参数类型

必填

参数描述

width

string | number

宽度。

默认值:0

说明:

异常值按照默认值处理。

height

string | number

高度。

默认值:0

说明:

异常值按照默认值处理。

属性

除支持通用属性外,还支持以下属性:

名称

类型

默认值

描述

fill

ResourceColor

Color.Black

设置填充区域颜色。

从API version 9开始,该接口支持在ArkTS卡片中使用。

说明:

异常值按照默认值处理。

fillOpacity

number | string | Resource

1

设置填充区域透明度。

从API version 9开始,该接口支持在ArkTS卡片中使用。

说明:

异常值按照默认值处理。

stroke

ResourceColor

-

设置边框颜色,不设置时,默认没有边框。

从API version 9开始,该接口支持在ArkTS卡片中使用。

说明:

异常值不会绘制边框。

strokeDashArray

Array<Length>

[]

设置边框间隙。

从API version 9开始,该接口支持在ArkTS卡片中使用。

说明:

异常值按照默认值处理。

strokeDashOffset

number | string

0

边框绘制起点的偏移量。

从API version 9开始,该接口支持在ArkTS卡片中使用。

说明:

异常值按照默认值处理。

strokeLineCap

LineCapStyle

LineCapStyle.Butt

设置边框端点绘制样式。

从API version 9开始,该接口支持在ArkTS卡片中使用。

strokeLineJoin

LineJoinStyle

LineJoinStyle.Miter

设置边框拐角绘制样式。

从API version 9开始,该接口支持在ArkTS卡片中使用。

说明:

Ellipse组件无法形成拐角,该属性设置无效。

strokeMiterLimit

number | string

4

设置斜接长度与边框宽度比值的极限值。

从API version 9开始,该接口支持在ArkTS卡片中使用。

说明:

Ellipse组件无法设置尖角图形,该属性设置无效。

strokeOpacity

number | string | Resource

1

设置边框透明度。

从API version 9开始,该接口支持在ArkTS卡片中使用。

说明:

该属性的取值范围是[0.0, 1.0],若给定值小于0.0,则取值为0.0;若给定值大于1.0,则取值为1.0,其余异常值按1.0处理 。

strokeWidth

Length

1

设置边框宽度。

从API version 9开始,该接口支持在ArkTS卡片中使用。

说明:

该属性若为string类型, 暂不支持百分比。

异常值按照默认值处理。

antiAlias

boolean

true

是否开启抗锯齿效果。

从API version 9开始,该接口支持在ArkTS卡片中使用。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct EllipseExample {
  5. build() {
  6. Column({ space: 10 }) {
  7. // 绘制一个 150 * 80 的椭圆
  8. Ellipse({ width: 150, height: 80 })
  9. // 绘制一个 150 * 100 、线条为蓝色的椭圆环
  10. Ellipse()
  11. .width(150)
  12. .height(100)
  13. .fillOpacity(0)
  14. .stroke(Color.Blue)
  15. .strokeWidth(3)
  16. }.width('100%')
  17. }
  18. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号