harmony 鸿蒙Circle

  • 2022-08-09
  • 浏览 (765)

Circle

The <Circle> component is used to draw a circle.

NOTE

This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.

Child Components

Not supported

APIs

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

Since API version 9, this API is supported in ArkTS widgets.

Parameters

Name Type Mandatory Description
width string |number No Width of the circle.
Default value: 0
NOTE
An invalid value is handled as the default value.
height string |number No Height of the circle.
Default value: 0
NOTE
An invalid value is handled as the default value.

Attributes

In addition to the universal attributes, the following attributes are supported.

Name Type Description
fill ResourceColor Color of the fill area.
Default value: Color.Black
Since API version 9, this API is supported in ArkTS widgets.
NOTE
An invalid value is handled as the default value.
fillOpacity number |string |Resource Opacity of the fill area.
Default value: 1
Since API version 9, this API is supported in ArkTS widgets.
NOTE
An invalid value is handled as the default value.
stroke ResourceColor Stroke color. If this attribute is not set, the component does not have any stroke.
Since API version 9, this API is supported in ArkTS widgets.
NOTE
If the value is invalid, no stroke will be drawn.
strokeDashArray Array&lt;Length&gt; Stroke dashes.
Default value: []
Since API version 9, this API is supported in ArkTS widgets.
NOTE
An invalid value is handled as the default value.
strokeDashOffset number |string Offset of the start point for drawing the stroke.
Default value: 0
Since API version 9, this API is supported in ArkTS widgets.
NOTE
An invalid value is handled as the default value.
strokeLineCap LineCapStyle Cap style of the stroke.
Default value: LineCapStyle.Butt
Since API version 9, this API is supported in ArkTS widgets.
strokeLineJoin LineJoinStyle Join style of the stroke.
Default value: LineJoinStyle.Miter
Since API version 9, this API is supported in ArkTS widgets.
strokeMiterLimit number |string Limit on the ratio of the miter length to the value of strokeWidth used to draw a miter join.
Default value: 4
Since API version 9, this API is supported in ArkTS widgets.
NOTE
This attribute does not take effect for the <Circle> component, because it does not have a miter join.
strokeOpacity number |string |Resource Stroke opacity.
Default value: 1
Since API version 9, this API is supported in ArkTS widgets.
NOTE
The value range is [0.0, 1.0]. A value less than 0.0 evaluates to the value 0.0. A value greater than 1.0 evaluates to the value 1.0. Any other value evaluates to the value 1.0.
strokeWidth Length Stroke width.
Default value: 1
Since API version 9, this API is supported in ArkTS widgets.
NOTE
The value cannot be a percentage.
An invalid value is handled as the default value.
antiAlias boolean Whether anti-aliasing is enabled.
Default value: true
Since API version 9, this API is supported in ArkTS widgets.

Example

// xxx.ets
@Entry
@Component
struct CircleExample {
  build() {
    Column({ space: 10 }) {
      // Draw a circle whose diameter is 150.
      Circle({ width: 150, height: 150 })
      // Draw a circle whose diameter is 150 and stroke color is red. (If the width and height values are different, the smaller value will be used as the diameter.)
      Circle()
        .width(150)
        .height(200)
        .fillOpacity(0)
        .strokeWidth(3)
        .stroke(Color.Red)
        .strokeDashArray([1, 2])
    }.width('100%')
  }
}

en-us_image_0000001219744191

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkTS-based Declarative Development Paradigm

harmony 鸿蒙@ohos.multimedia.avCastPicker (AVCastPicker)

harmony 鸿蒙Property Animation

harmony 鸿蒙Enums

harmony 鸿蒙Blank

harmony 鸿蒙Button

harmony 鸿蒙CalendarPicker

harmony 鸿蒙Checkbox

harmony 鸿蒙CheckboxGroup

harmony 鸿蒙DataPanel

0  赞