鸿蒙开发设备管理:【@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 是 否 触摸来源的设备类型
相关推荐
李游Leo15 分钟前
HarmonyOS 7 Core Vision Kit + Image Kit:超分批处理的 PixelMap 预算、失败降级与结果原子替换【鸿蒙心迹】
harmonyos
李游Leo25 分钟前
HarmonyOS 7 AbilityAccessCtrl + ArkUI:权限弹窗重入治理与提审证据链【鸿蒙心迹】
华为·harmonyos
李游Leo1 小时前
HarmonyOS 7 Spatial Recon Kit + Preferences:重建会话中断恢复与脏任务回收【鸿蒙心迹】
华为·harmonyos
阿里嘎多学长1 小时前
2026-09-29 GitHub 热点项目精选
开发语言·程序员·github·代码托管
李游Leo2 小时前
《HarmonyOS 7 ArkGraphics 3D 空间设计开发实战》03:glTF模型加载、实例复用与资源生命周期【鸿蒙心迹】
3d·harmonyos
李游Leo3 小时前
HarmonyOS 7 + ArkTS-HUKS:精准碰一碰载荷的签名校验与重放窗口【鸿蒙心迹】
华为·harmonyos
花花_13 小时前
HarmonyOS 7 状态手记 01|页面状态别乱放
华为·harmonyos
JustHappy3 小时前
「vConsole MCP🛠️」我让 AI 直接看见任何 H5 的日志和请求帮你 debug
前端·javascript·程序员
李游Leo4 小时前
HarmonyOS 7 + Hvigor-Localization Kit:多语言资源占位符签名与回退链路预检【鸿蒙心迹】
harmonyos
李游Leo4 小时前
HarmonyOS 7 AVSession + Float Window:闪控窗播放控制权的会话移交与重复指令去重【鸿蒙心迹】
华为·harmonyos