@ohos.multimodalInput.touchEvent (触摸输入事件)

设备上报的触屏事件,继承自InputEvent

说明:

本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import {Action,ToolType,SourceType,Touch,TouchEvent} from '@ohos.multimodalInput.touchEvent';

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 工具类型

TouchEvent

触屏事件。

系统能力:SystemCapability.MultimodalInput.Input.Core

名称 类型 可读 可写 说明
action Action 触摸动作
touch Touch 当前触摸点
touches Touch[] 所有触摸点
sourceType SourceType 触摸来源的设备类型