鸿蒙开发设备管理:【@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 触摸来源的设备类型
相关推荐
HwJack202 分钟前
鸿蒙背景下 Cocos Creator 的三大 JS 引擎:JIT 与热更新的十字路口
javascript·华为·harmonyos
提子拌饭13313 分钟前
Column 嵌套布局:多级 Column 实现复杂纵向结构——鸿蒙 HarmonyOS ArkTS 原生学习应用
学习·华为·harmonyos·鸿蒙·鸿蒙系统
阿里嘎多学长2 小时前
2026-06-08 GitHub 热点项目精选
开发语言·程序员·github·代码托管
AINative软件工程2 小时前
用了 AI Coding 半年,代码量翻倍但维护变难:我们团队的「技术债决策矩阵」
程序员
前端不太难2 小时前
鸿蒙 App 分布式数据同步:架构设计 + Demo 实现
分布式·状态模式·harmonyos
SimonKing3 小时前
实用,DynamicTP进阶之数据采集与告警
java·后端·程序员
DogDaoDao3 小时前
【GitHub】AutoGPT 深度技术解析:开源自主 AI Agent 平台架构全解
人工智能·程序员·开源·github·ai编程·ai agent·智能体
Captaincc4 小时前
置身钉内:一个 AI 办公产品的理想、失焦与组织困境
前端·程序员
腾科IT教育4 小时前
从“韬定律“到鸿蒙生态:国产芯片底层突围,如何重塑应用开发的游戏规则?
华为·harmonyos
坚果派·白晓明4 小时前
鸿蒙PC适配实战:simdjson 三方库移植攻略与 AtomCode Skills 提效之道
c++·harmonyos·三方库·skills·atomcode·c/c++三方库·c/c++三方库适配