ts-drawing-components-line.md 1.7 KB
Newer Older
Z
zengyawen 已提交
1
# Line
Z
zengyawen 已提交
2

Z
zengyawen 已提交
3

4
> **NOTE**<br>
Z
zengyawen 已提交
5
> This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
Z
zengyawen 已提交
6

Z
zengyawen 已提交
7

8
The **<Line\>** component is used to draw a straight line.
Z
zengyawen 已提交
9 10 11


## Required Permissions
Z
zengyawen 已提交
12 13 14

None

Z
zengyawen 已提交
15 16

## Child Components
Z
zengyawen 已提交
17 18 19 20

None


Z
zengyawen 已提交
21 22 23 24 25
## APIs

Line(options?: {width: Length, height: Length})

- Parameters
26
  | Name | Type | Mandatory | Default Value | Description | 
Z
zengyawen 已提交
27
  | -------- | -------- | -------- | -------- | -------- |
28
  | options | Object | No | - | Options of the line to draw. For details, see the **options** parameters. | 
Z
zengyawen 已提交
29 30

- options parameters
31
  | Name | Type | Mandatory | Default Value | Description | 
Z
zengyawen 已提交
32
  | -------- | -------- | -------- | -------- | -------- |
33 34
  | width | Length | Yes | - | Line width. | 
  | height | Length | Yes | - | Line height. | 
Z
zengyawen 已提交
35 36 37 38


## Attributes

39
| Name | Type | Default Value | Mandatory | Description | 
Z
zengyawen 已提交
40
| -------- | -------- | -------- | -------- | -------- |
E
esterzhou 已提交
41 42 43 44
| width | Length | 0 | No | Width of the rectangle where the straight line is located. | 
| height | Length | 0 | No | Height of the rectangle where the straight line is located. | 
| startPoint | Point | [0, 0] | Yes | Coordinate (relative coordinate) of the start point of the straight line. | 
| endPoint | Point | [0, 0] | Yes | Coordinate (relative coordinate) of the end point of the straight line. | 
Z
zengyawen 已提交
45 46 47 48 49


## Example

  
Z
zengyawen 已提交
50 51 52 53 54 55 56 57 58 59 60 61 62
```
@Entry
@Component
struct LineExample {
  build() {
    Column() {
      Line({ width: 50, height: 100 }).startPoint([0, 0]).endPoint([50, 100])
      Line().width(200).height(200).startPoint([50, 50]).endPoint([150, 150])
    }.margin({ top: 5 })
  }
}
```

Z
zengyawen 已提交
63
![en-us_image_0000001256858387](figures/en-us_image_0000001256858387.jpg)