鸿蒙开发设备管理:【@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 触摸来源的设备类型
相关推荐
芙莉莲教你写代码6 小时前
Flutter 框架跨平台鸿蒙开发 - 考试倒计时
flutter·华为·harmonyos
阿里嘎多学长6 小时前
2026-04-05 GitHub 热点项目精选
开发语言·程序员·github·代码托管
枫叶丹48 小时前
【HarmonyOS 6.0】ArkUI Scroll组件新特性:手势缩放能力全解析
microsoft·华为·harmonyos
木斯佳9 小时前
HarmonyOS 6实战:HarmonyOS轻量化交互的两种方案改造与实践(上)
交互·harmonyos
i建模9 小时前
目前支持鸿蒙的跨平台开源项目
华为·开源·harmonyos
讯方洋哥10 小时前
鸿蒙ArkTS和华为云Java构建及mysql数据库端云协同机制实战
harmonyos
想你依然心痛10 小时前
HarmonyOS 5.0企业级办公APP开发实战:基于元服务的轻量化协同办公与智能会议系统
华为·harmonyos
芙莉莲教你写代码11 小时前
Flutter 框架跨平台鸿蒙开发 - 气泡消除游戏
flutter·游戏·华为·harmonyos
盐焗西兰花11 小时前
鸿蒙学习实战之路-Share Kit系列(15/17)-手机与PC/2in1设备间分享
学习·智能手机·harmonyos
不喝水就会渴12 小时前
鸿蒙 hdsEffect 模块全解析:从点光源到流光,视效开发实战指南
华为·harmonyos