鸿蒙开发设备管理:【@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 是 否 触摸来源的设备类型
相关推荐
行走的小派36 分钟前
Harmony文件管理子系统实践:纯文本编辑器的大文件加载与编码处理
harmonyos·香橙派·应用开发
SimonKing1 小时前
DeepSeek 新模型免费白嫖,夯夯夯,赶紧用起来
java·后端·程序员
hqzing1 小时前
在鸿蒙 PC 上使用 apt 安装 Debian 软件包(非虚拟机、非容器)
华为·debian·harmonyos
Marco_Marco1352 小时前
定位SDK接入实战:Android/iOS/鸿蒙三端怎么选、怎么接
android·ios·harmonyos
梦想不只是梦与想2 小时前
鸿蒙应用:区分真机和模拟器
harmonyos·deviceinfo·productmodel
时间的情敌2 小时前
鸿蒙开发日常随笔|写代码、调真机、踩坑碎碎念
华为·harmonyos
阿里嘎多学长11 小时前
2026-10-20 GitHub 热点项目精选
开发语言·程序员·github·代码托管
ToDesk_Daas12 小时前
深度适配鸿蒙生态,ToDesk 迎来版本升级,全面优化远程操控体验
华为·harmonyos
贾伟康12 小时前
【化学实验室|15】HarmonyOS ArkTS 本地状态持久化实战:让保存、删除和页面返回后的数据即时一致
harmonyos·arkts·本地存储·arkui·preferences
kyriewen15 小时前
我抽查了 6 万个 Skills:前排没几个真货
人工智能·程序员·ai编程