鸿蒙开发设备管理:【@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 触摸来源的设备类型
相关推荐
duluo13312 小时前
鸿蒙NEXT实战:从零构建高尔夫挥杆教学App(API 24 / ArkTS 深度解析)
华为·harmonyos·鸿蒙·鸿蒙系统
zjxcq52013 小时前
鸿蒙深入理解 HarmonyOS NEXT ArkTS 中 `height(‘100%‘)` 在嵌套容器中的行为机制
华为·harmonyos
贾伟康13 小时前
【补能雷达 Skill|20】项目复盘与升级路线:从 Web Demo 到真正的车主补能助手
harmonyos·ai智能体·高德开放平台·高德skill
陈随易16 小时前
Rust、Golang、MoonBit 编译成 WASM,体积和速度差距有多大?
前端·后端·程序员
国服第二切图仔17 小时前
HarmonyOS APP《画伴梦工厂》开发第38篇-自适应布局API实战——adaptiveLayout模块
华为·harmonyos
特立独行的猫A17 小时前
HarmonyOS鸿蒙原生包HNP全解析:从规范到实战的完整指南
harmonyos
阿里嘎多学长20 小时前
2026-07-03 GitHub 热点项目精选
开发语言·程序员·github·代码托管
nashane21 小时前
HarmonyOS 6商城开发学习:剪贴板权限频繁弹窗的根治——从“自动嗅探“改为“用户主动触发“模型
华为·harmonyos
国服第二切图仔21 小时前
HarmonyOS APP《画伴梦工厂》开发第37篇-GridRow-GridCol——响应式网格布局
华为·harmonyos
痕忆丶21 小时前
openharmony开发基础之5.0.1版本文件管理器复制粘贴框架调用流程
harmonyos