鸿蒙开发设备管理:【@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 是 否 触摸来源的设备类型
相关推荐
深蓝AI4 小时前
为什么 agent 的 demo 都很惊艳,上了生产就不靠谱
人工智能·程序员
深蓝AI5 小时前
一个项目五个 AI 同时干活,Claude Code 怎么让它们不互相打架
人工智能·程序员
Sirius_Ji9 小时前
# 一份鸿蒙原生支持硬解的 ffmpeg 开发基座
harmonyos
贾伟康10 小时前
HarmonyOS API 26 Navigation路由栈上限:stackSizeLimit、过载保护与容量观测
harmonyos·arkts·navigation·navpathstack·api26
江华森15 小时前
把鸿蒙云手机调试的 5 个坑写成 Skill:12 项检查清单与报错决策树
harmonyos
木木子2216 小时前
用华为云码道构建校园导航应用「新生通」:从需求分析到工程落地
华为·华为云·harmonyos
贾伟康18 小时前
HarmonyOS API 26 Navigation 自适应模式:mode、分栏切换与窗口断点治理
harmonyos·arkts·arkui·navigation·自适应布局
贾伟康18 小时前
【转盘决定吧|07】HarmonyOS ArkTS 6.0.2.130 趣味题库:场景分类、随机选择与详情页解耦
harmonyos·arkts·路由·数据建模·arkui
贾伟康18 小时前
【电路实验模拟|03】HarmonyOS ArkTS 交通灯实战:用定时状态切换红黄绿灯
harmonyos·arkts·canvas·arkui·交通灯
贾伟康1 天前
HarmonyOS API 26 嵌套 Navigation:getParent、父子栈边界与返回分发
harmonyos·arkts·navigation·嵌套路由·navpathstack