js-apis-touchevent.md 3.8 KB
Newer Older
S
shaoziyun 已提交
1 2
# 触摸输入事件

S
shaoziyun 已提交
3
设备上报的触屏事件。
S
m11  
shaoziyun 已提交
4

H
HelloCrease 已提交
5 6
>  **说明:**
>
S
m11  
shaoziyun 已提交
7 8 9 10
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

## 导入模块

S
shaoziyun 已提交
11
```js
S
shaoziyun 已提交
12
import {Action,ToolType,SourceType,Touch,TouchEvent} from '@ohos.multimodalInput.touchEvent';
S
m11  
shaoziyun 已提交
13 14
```

S
shaoziyun 已提交
15
## Action
S
m11  
shaoziyun 已提交
16

H
HelloCrease 已提交
17
**系统能力**:SystemCapability.MultimodalInput.Input.Core
S
m11  
shaoziyun 已提交
18

M
mayunteng_1 已提交
19 20 21 22 23 24
| 名称     | 值   | 说明   |
| ------ | ------ | ---- |
| CANCEL | 0 | 触摸取消 |
| DOWN   | 1 | 触摸按下 |
| MOVE   | 2 | 触摸移动 |
| UP     | 3 | 触摸抬起 |
S
m11  
shaoziyun 已提交
25

S
shaoziyun 已提交
26
## ToolType
S
m11  
shaoziyun 已提交
27

H
HelloCrease 已提交
28
**系统能力**:SystemCapability.MultimodalInput.Input.Core
S
m11  
shaoziyun 已提交
29

M
mayunteng_1 已提交
30 31 32 33 34 35 36 37 38 39
| 名称       | 值   | 说明   |
| -------- | ------ | ---- |
| FINGER   | 0 | 手指   |
| PEN      | 1 | 笔    |
| RUBBER   | 2 | 橡皮擦  |
| BRUSH    | 3 | 笔刷   |
| PENCIL   | 4 | 铅笔   |
| AIRBRUSH | 5 | 气笔   |
| MOUSE    | 6 | 鼠标   |
| LENS     | 7 | 透镜   |
S
m11  
shaoziyun 已提交
40

S
shaoziyun 已提交
41
## SourceType 
S
m11  
shaoziyun 已提交
42

H
HelloCrease 已提交
43
**系统能力**:SystemCapability.MultimodalInput.Input.Core
S
m11  
shaoziyun 已提交
44

M
mayunteng_1 已提交
45 46 47 48 49
| 名称           | 值  | 说明   |
| ------------ | ------ | ---- |
| TOUCH_SCREEN | 0 | 触摸屏  |
| PEN          | 1 | 手写笔  |
| TOUCH_PAD    | 2 | 触摸板  |
S
m11  
shaoziyun 已提交
50

S
shaoziyun 已提交
51
## Touch
S
m11  
shaoziyun 已提交
52

H
HelloCrease 已提交
53 54
**系统能力**:SystemCapability.MultimodalInput.Input.Core

M
mayunteng_1 已提交
55
| 名称          | 类型   | 可读   | 可写   | 说明                                  |
H
HelloCrease 已提交
56
| ----------- | ------ | ---- | ---- | ----------------------------------- |
M
mayunteng_1 已提交
57 58
| id          | number | 是    | 否    | 触摸事件标识                                |
| pressedTime | number | 是    | 否    | 按下时间戳                             |
H
HelloCrease 已提交
59 60 61 62 63
| screenX     | number | 是    | 否    | 触摸位置所属的屏幕x坐标                        |
| screenY     | number | 是    | 否    | 触摸位置所属的屏幕y坐标                        |
| windowX     | number | 是    | 否    | 触摸位置在窗口中的x坐标                        |
| windowY     | number | 是    | 否    | 触摸位置在窗口中的y坐标                        |
| pressure    | number | 是    | 否    | 压力值,取值范围是[0.0, 1.0], 0.0表示不支持       |
M
mayunteng_1 已提交
64 65
| width       | number | 是    | 否    | 触摸区域的宽度                           |
| height      | number | 是    | 否    | 触摸区域的高度                           |
H
HelloCrease 已提交
66 67
| tiltX       | number | 是    | 否    | 相对YZ平面的角度,取值的范围[-90, 90],其中正值是向右倾斜。 |
| tiltY       | number | 是    | 否    | 相对XZ平面的角度,值的范围[-90, 90],其中正值是向下倾斜。  |
M
mayunteng_1 已提交
68 69
| toolX       | number | 是    | 否    | 工具区域的中心点x坐标                           |
| toolY       | number | 是    | 否    | 工具区域的中心点y坐标                           |
H
HelloCrease 已提交
70 71 72 73
| toolWidth   | number | 是    | 否    | 工具区域宽度                              |
| toolHeight  | number | 是    | 否    | 工具区域高度                              |
| rawX        | number | 是    | 否    | 输入设备上的x坐标                           |
| rawY        | number | 是    | 否    | 输入设备上的y坐标                           |
M
mayunteng_1 已提交
74
| toolType    | ToolType | 是    | 否    | 工具类型                                |
S
m11  
shaoziyun 已提交
75

S
shaoziyun 已提交
76
## TouchEvent
S
m11  
shaoziyun 已提交
77

H
HelloCrease 已提交
78
**系统能力**:SystemCapability.MultimodalInput.Input.Core
S
m11  
shaoziyun 已提交
79

M
mayunteng_1 已提交
80
| 名称         | 类型       | 可读   | 可写   | 说明        |
H
HelloCrease 已提交
81 82 83 84 85
| ---------- | ---------- | ---- | ---- | --------- |
| action     | Action     | 是    | 否    | 触摸动作      |
| touch      | Touch      | 是    | 否    | 当前触摸点     |
| touches    | Touch[]    | 是    | 否    | 所有触摸点     |
| sourceType | SourceType | 是    | 否    | 触摸来源的设备类型 |