触摸输入事件
2024-01-23 17:37 更新
设备上报的触屏事件。
说明
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
Action
触屏事件类型。
系统能力：SystemCapability.MultimodalInput.Input.Core
| 名称 | 值 | 说明 |
|---|---|---|
| CANCEL | 0 | 触摸取消 |
| DOWN | 1 | 触摸按下 |
| MOVE | 2 | 触摸移动 |
| UP | 3 | 触摸抬起 |
ToolType
操作触屏的工具类型。
系统能力：SystemCapability.MultimodalInput.Input.Core
| 名称 | 值 | 说明 |
|---|---|---|
| FINGER | 0 | 手指 |
| PEN | 1 | 笔 |
| RUBBER | 2 | 橡皮擦 |
| BRUSH | 3 | 笔刷 |
| PENCIL | 4 | 铅笔 |
| AIRBRUSH | 5 | 气笔 |
| MOUSE | 6 | 鼠标 |
| LENS | 7 | 透镜 |
SourceType
触摸来源的设备类型。
系统能力：SystemCapability.MultimodalInput.Input.Core
| 名称 | 值 | 说明 |
|---|---|---|
| TOUCH_SCREEN | 0 | 触摸屏 |
| PEN | 1 | 手写笔 |
| TOUCH_PAD | 2 | 触摸板 |
Touch
触摸点信息。
系统能力：SystemCapability.MultimodalInput.Input.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
|---|---|---|---|---|
| id | number | 是 | 否 | 触摸事件标识 |
| pressedTime | number | 是 | 否 | 按下时间戳 |
| screenX | number | 是 | 否 | 触摸位置所属的屏幕x坐标 |
| screenY | number | 是 | 否 | 触摸位置所属的屏幕y坐标 |
| windowX | number | 是 | 否 | 触摸位置在窗口中的x坐标 |
| windowY | number | 是 | 否 | 触摸位置在窗口中的y坐标 |
| pressure | number | 是 | 否 | 压力值，取值范围是[0.0, 1.0], 0.0表示不支持 |
| width | number | 是 | 否 | 触摸区域的宽度 |
| height | number | 是 | 否 | 触摸区域的高度 |
| tiltX | number | 是 | 否 | 相对YZ平面的角度,取值的范围[-90, 90]，其中正值是向右倾斜。 |
| tiltY | number | 是 | 否 | 相对XZ平面的角度,值的范围[-90, 90]，其中正值是向下倾斜。 |
| toolX | number | 是 | 否 | 工具区域的中心点x坐标 |
| toolY | number | 是 | 否 | 工具区域的中心点y坐标 |
| toolWidth | number | 是 | 否 | 工具区域宽度 |
| toolHeight | number | 是 | 否 | 工具区域高度 |
| rawX | number | 是 | 否 | 输入设备上的x坐标 |
| rawY | number | 是 | 否 | 输入设备上的y坐标 |
| toolType | ToolType | 是 | 否 | 工具类型 |
以上内容是否对您有帮助：
← 鼠标指针
更多建议：