鸿蒙开发设备管理:【@ohos.multimodalInput.touchEvent (触摸输入事件)】

触摸输入事件

设备上报的触屏事件。

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

导入模块

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

Action

系统能力:以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core

名称 参数类型 可读 可写 描述
CANCEL number 是 否 触摸取消
DOWN number 是 否 触摸按下
MOVE number 是 否 触摸移动
UP number 是 否 触摸抬起

ToolType

系统能力:以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core

名称 参数类型 可读 可写 描述
FINGER number 是 否 手指
PEN number 是 否 笔
RUBBER number 是 否 橡皮擦
BRUSH number 是 否 笔刷
PENCIL number 是 否 铅笔
AIRBRUSH number 是 否 气笔
MOUSE number 是 否 鼠标
LENS number 是 否 透镜

SourceType

系统能力:以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core

名称 参数类型 可读 可写 描述
TOUCH_SCREEN number 是 否 触摸屏
PEN number 是 否 手写笔
TOUCH_PAD number 是 否 触摸板

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

TouchEvent

系统能力:以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core

名称 参数类型 可读 可写 描述
action Action 是 否 触摸动作
touch Touch 是 否 当前触摸点
touches Touch\[\] 是 否 所有触摸点
sourceType SourceType 是 否 触摸来源的设备类型
相关推荐
2601_949480063 小时前
开源鸿蒙平台 CMP 三方库「shadcn」适配全流程
华为·开源·harmonyos
Liaiyang665 小时前
空圈容错视角-HarmonyOS 7 架构体检:从被动容错到主动免疫的真伪验证与生态反推
操作系统·harmonyos·架构设计·ai-agent·端云协同·鸿蒙7·空圈容错
贾伟康5 小时前
【共创稿事节】HarmonyOS 7.0 Native XComponent与FFI:从接入到生产验证
harmonyos·profiler·hitracemeter·性能追踪·时间线
redtank20007 小时前
纯血鸿蒙本地电子书阅读器实测:九格式支持、沉浸阅读与零联网隐私设计
华为·harmonyos
贾伟康7 小时前
【共创稿事节】HarmonyOS 7.0 HiSysEvent系统事件订阅:从接入到生产验证
harmonyos·可观测性·hisyevent·系统事件·后台优化
独隅9 小时前
HarmonyOS 系统能力与体验深度评测 - 超详细版
华为·harmonyos
懿路向前10 小时前
唤醒工作台全实录(六):数据层——5ms 竞态窗口与“查询即引用“
华为·架构·harmonyos
KevinChaos10 小时前
灶台菜谱设计手记 04|HarmonyOS 7.0 空间化:信息折叠展开
harmonyos
LV技术派11 小时前
【成为 AI Native Builder · 02】什么是 AI Native Builder:一个人 + AI,交付完整闭环
前端·程序员·ai编程
贾伟康12 小时前
【共创稿事节】HarmonyOS 7.0 HiTraceChain分布式调用链:从接入到生产验证
分布式·harmonyos·可观测性·调用链·hitracechain