鸿蒙开发设备管理:【@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 触摸来源的设备类型
相关推荐
fakerth1 分钟前
【OpenHarmony】startup_init 模块
操作系统·openharmony
richard_yuu16 分钟前
鸿蒙心理测评模块实战|PHQ-9/GAD7双量表答题、实时计分与结果本地化存储
华为·harmonyos
Patrick_Wilson1 小时前
知识沉淀的四层模型:从个人笔记到企业资产,让文档真正长出复利
面试·程序员·ai编程
阿凡9807302 小时前
花 100 dollar,用 Claude 打通 EasyEDA&Fusion 双向同步
后端·程序员
不爱吃糖的程序媛3 小时前
2026年Electron 鸿蒙PC环境搭建指南
人工智能·华为·harmonyos
nashane3 小时前
HarmonyOS 6学习:长截图功能开发中的滚动拼接与权限处理实战
人工智能·华为·harmonyos
大师兄66685 小时前
从零开发一个 HarmonyOS 输入法——KikaInputMethod 完整拆解
harmonyos·服务卡片·harmonyos6·formkit
一叶遮惊鸿9 小时前
从0开始搭建mcp
程序员
Python私教10 小时前
鸿蒙 NEXT 也能接 MCP?用 ArkTS 跑通 AI Agent 工具链
人工智能·华为·harmonyos
Duang10 小时前
我把 Claude、Codex、Copilot、Gemini 拼成了一个工作流,接力写代码
人工智能·程序员·架构