鸿蒙开发设备管理:【@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 是 否 触摸来源的设备类型
相关推荐
独隅7 分钟前
HarmonyOS 系统能力与体验深度评测
华为·harmonyos·harmonyos 7.0
2601_949575867 分钟前
开源鸿蒙平台 CMP 三方库「Persian-Date-picker」适配全流程
华为·开源·harmonyos
喜欢吃豆1 小时前
我把开源数字人项目升级了:xingyun3D 不只会念台词,还能陪你聊天、练面试
程序员
KevinChaos1 小时前
灶台菜谱设计手记 02|HarmonyOS 7.0 空间化:菜图滚动实现
harmonyos
独隅2 小时前
HarmonyOS 全场景智能应用落地指南
华为·harmonyos·harmonyos 7.0
熊猫钓鱼>_>2 小时前
鸿蒙PC构建实战:hvigor modelVersion 降级 + schema 清理 + ArkTS 编译三连坑完整复盘
开发语言·华为·ai编程·harmonyos·openharmony·数据·ai生成
2601_949970692 小时前
开源鸿蒙平台 CMP 三方库「SaltUI」适配全流程
华为·开源·harmonyos
马剑威(威哥爱编程)2 小时前
【HarmonyOS 7 小艺智能体实战】06:VibeCoding 十分钟搓出一个 Skill(上)——从想法到生成
人工智能·华为·harmonyos
马剑威(威哥爱编程)3 小时前
【HarmonyOS 7 小艺智能体实战】07:手写一个 Skill(下)——ArkTS、意图框架与工程结构
人工智能·华为·harmonyos
深蓝AI4 小时前
Epic 摊牌了:Claude 和 Codex 在写 UE6 的代码,十年没修掉的 bug 被 AI 扫光
程序员·ai编程