鸿蒙开发设备管理:【@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 触摸来源的设备类型
相关推荐
大雷神5 小时前
HarmonyOS ArkGraphics 2D 自定义字体实操:注册字体并验证中文回退
pytorch·华为·harmonyos
Nayana6 小时前
《Web 到 HarmonyOS》-- 第一课:前端经验哪些能带走
vue.js·harmonyos
大雷神7 小时前
HarmonyOS ArkGraphics 2D 复杂文本排版实操:用 ParagraphBuilder 做资讯阅读卡片
华为·harmonyos
大雷神7 小时前
HarmonyOS ArkGraphics 2D NativeImage 实操:获取 NativeWindow 与 SurfaceId
华为·harmonyos
小玮看世界7 小时前
当“教用户配置系统“成为产品的遮羞布:从鸿蒙拦截栈与小红书联系机制看科技公司的“驯化式创新“
科技·华为·harmonyos
阿里嘎多学长7 小时前
2026-09-05 GitHub 热点项目精选
开发语言·程序员·github·代码托管
梦想不只是梦与想7 小时前
鸿蒙 应用类型:企业应用
华为·harmonyos·企业应用
大雷神8 小时前
HarmonyOS ArkGraphics 2D 文本绘制实操:用 TextBlob 做动态文字排版
华为·harmonyos
搬砖的kk8 小时前
从 0 到 1:用 KMP + Compose Multiplatform + Ktor 实现鸿蒙「历史上的今天」应用
开源·harmonyos
星辰徐哥8 小时前
鸿蒙PC平台 Gnote 笔记应用适配实战:从 Linux 到 鸿蒙PC 的 Electron 迁移
linux·笔记·electron·harmonyos·gnote