• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.multimodalInput.touchEvent (触摸输入事件)
2
3设备上报的触屏事件。
4
5>  **说明:**
6>
7> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```js
12import {Action,ToolType,SourceType,Touch,TouchEvent} from '@ohos.multimodalInput.touchEvent';
13```
14
15## Action
16
17触屏事件类型。
18
19**系统能力**:SystemCapability.MultimodalInput.Input.Core
20
21| 名称     | 值   | 说明   |
22| ------ | ------ | ---- |
23| CANCEL | 0 | 触摸取消 |
24| DOWN   | 1 | 触摸按下 |
25| MOVE   | 2 | 触摸移动 |
26| UP     | 3 | 触摸抬起 |
27
28## ToolType
29
30操作触屏的工具类型。
31
32**系统能力**:SystemCapability.MultimodalInput.Input.Core
33
34| 名称       | 值   | 说明   |
35| -------- | ------ | ---- |
36| FINGER   | 0 | 手指   |
37| PEN      | 1 | 笔    |
38| RUBBER   | 2 | 橡皮擦  |
39| BRUSH    | 3 | 笔刷   |
40| PENCIL   | 4 | 铅笔   |
41| AIRBRUSH | 5 | 气笔   |
42| MOUSE    | 6 | 鼠标   |
43| LENS     | 7 | 透镜   |
44
45## SourceType
46
47触摸来源的设备类型。
48
49**系统能力**:SystemCapability.MultimodalInput.Input.Core
50
51| 名称           | 值  | 说明   |
52| ------------ | ------ | ---- |
53| TOUCH_SCREEN | 0 | 触摸屏  |
54| PEN          | 1 | 手写笔  |
55| TOUCH_PAD    | 2 | 触摸板  |
56
57## Touch
58
59触摸点信息。
60
61**系统能力**:SystemCapability.MultimodalInput.Input.Core
62
63| 名称          | 类型   | 可读   | 可写   | 说明                                  |
64| ----------- | ------ | ---- | ---- | ----------------------------------- |
65| id          | number | 是    | 否    | 触摸事件标识                                |
66| pressedTime | number | 是    | 否    | 按下时间戳                             |
67| screenX     | number | 是    | 否    | 触摸位置所属的屏幕x坐标                        |
68| screenY     | number | 是    | 否    | 触摸位置所属的屏幕y坐标                        |
69| windowX     | number | 是    | 否    | 触摸位置在窗口中的x坐标                        |
70| windowY     | number | 是    | 否    | 触摸位置在窗口中的y坐标                        |
71| pressure    | number | 是    | 否    | 压力值,取值范围是[0.0, 1.0], 0.0表示不支持       |
72| width       | number | 是    | 否    | 触摸区域的宽度                           |
73| height      | number | 是    | 否    | 触摸区域的高度                           |
74| tiltX       | number | 是    | 否    | 相对YZ平面的角度,取值的范围[-90, 90],其中正值是向右倾斜。 |
75| tiltY       | number | 是    | 否    | 相对XZ平面的角度,值的范围[-90, 90],其中正值是向下倾斜。  |
76| toolX       | number | 是    | 否    | 工具区域的中心点x坐标                           |
77| toolY       | number | 是    | 否    | 工具区域的中心点y坐标                           |
78| toolWidth   | number | 是    | 否    | 工具区域宽度                              |
79| toolHeight  | number | 是    | 否    | 工具区域高度                              |
80| rawX        | number | 是    | 否    | 输入设备上的x坐标                           |
81| rawY        | number | 是    | 否    | 输入设备上的y坐标                           |
82| toolType    | ToolType | 是    | 否    | 工具类型                                |
83
84## TouchEvent
85
86触屏事件。
87
88**系统能力**:SystemCapability.MultimodalInput.Input.Core
89
90| 名称         | 类型       | 可读   | 可写   | 说明        |
91| ---------- | ---------- | ---- | ---- | --------- |
92| action     | Action     | 是    | 否    | 触摸动作      |
93| touch      | Touch      | 是    | 否    | 当前触摸点     |
94| touches    | Touch[]    | 是    | 否    | 所有触摸点     |
95| sourceType | SourceType | 是    | 否    | 触摸来源的设备类型 |
96