鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(触摸事件)

OpenHarmony实战开发-使用通用事件、触屏事件 触屏事件指当手指/手写笔在组件上按下、滑动、抬起时触发的回调事件。包括点击事件、拖拽事件和触摸事件。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


触摸事件

当手指在组件上按下、滑动、抬起时触发。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

onTouch

onTouch(event: (event: TouchEvent) => void): T

手指触摸动作触发该回调。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
eventTouchEvent是获得TouchEvent对象。

返回值:

类型说明
T返回当前组件。

TouchEvent对象说明

继承于BaseEvent。非事件注入场景下,changedTouches是按屏幕显示刷新率重采样的点,touches是按器件刷新率报上来的点,changedTouches的数据可能会和touches里面的不相同。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型描述
typeTouchType

触摸事件的类型。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

touchesArray<TouchObject>

全部手指信息。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

changedTouchesArray<TouchObject>

当前发生变化的手指信息。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

stopPropagation() => void

阻塞事件冒泡。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

preventDefault12+() => void

阻止默认事件,具体功能暂未实现。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

getHistoricalPoints10+

getHistoricalPoints(): Array<HistoricalPoint>

获取当前帧所有的历史点。不同设备每帧的触摸事件频率不同,且该接口只能在TouchEvent中调用,可以通过该接口获取触发onTouch时当前帧历史点的相关信息。onTouch一帧只会调用一次,若当前帧收到的TouchEvent大于1,会将该帧最后一个点通过onTouch返还,剩余点作为历史点。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

返回值:

类型描述
Array<HistoricalPoint>由历史点组成的数组。

TouchObject对象说明

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型描述
typeTouchType

触摸事件的类型。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

idnumber

手指唯一标识符。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

xnumber

触摸点相对于事件响应组件的左上角的X坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

ynumber

触摸点相对于事件响应组件的左上角的Y坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

windowX10+number

触摸点相对于应用窗口左上角的X坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

windowY10+number

触摸点相对于应用窗口左上角的Y坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

displayX10+number

触摸点相对于应用屏幕左上角的X坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

displayY10+number

触摸点相对于应用屏幕左上角的Y坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

screenX(deprecated)number

触摸点相对于应用窗口左上角的X坐标。

单位:vp

从API version 10开始不再维护,建议使用windowX代替。

screenY(deprecated)number

触摸点相对于应用窗口左上角的Y坐标。

单位:vp

从API version 10开始不再维护,建议使用windowY代替。

HistoricalPoint10+对象说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型描述
touchObjectTouchObject历史点对应触摸事件的基础信息。
sizenumber

历史点对应触摸事件的手指与屏幕的触摸区域大小。

默认值:0

forcenumber

历史点对应触摸事件的压力大小。

默认值:0

取值范围:[0,65535),压力越大值越大。

timestampnumber

历史点对应触摸事件的时间戳。触发事件时距离系统启动的时间间隔。

单位:ns

示例

该示例通过按钮设置了触摸事件,手指点击按钮时可获取触摸事件的相关参数。

// xxx.ets
@Entry
@Component
struct TouchExample {
@State text: string = ''
@State eventType: string = ''

build() {
Column() {
Button('Touch').height(40).width(100)
.onTouch((event?: TouchEvent) => {
if(event){
if (event.type === TouchType.Down) {
this.eventType = 'Down'
}
if (event.type === TouchType.Up) {
this.eventType = 'Up'
}
if (event.type === TouchType.Move) {
this.eventType = 'Move'
}
this.text = 'TouchType:' + this.eventType + '\nDistance between touch point and touch element:\nx: '
+ event.touches[0].x + '\n' + 'y: ' + event.touches[0].y + '\nComponent globalPos:('
+ event.target.area.globalPosition.x + ',' + event.target.area.globalPosition.y + ')\nwidth:'
+ event.target.area.width + '\nheight:' + event.target.area.height
}
})
Button('Touch').height(50).width(200).margin(20)
.onTouch((event?: TouchEvent) => {
if(event){
if (event.type === TouchType.Down) {
this.eventType = 'Down'
}
if (event.type === TouchType.Up) {
this.eventType = 'Up'
}
if (event.type === TouchType.Move) {
this.eventType = 'Move'
}
this.text = 'TouchType:' + this.eventType + '\nDistance between touch point and touch element:\nx: '
+ event.touches[0].x + '\n' + 'y: ' + event.touches[0].y + '\nComponent globalPos:('
+ event.target.area.globalPosition.x + ',' + event.target.area.globalPosition.y + ')\nwidth:'
+ event.target.area.width + '\nheight:' + event.target.area.height
}
})
Text(this.text)
}.width('100%').padding(30)
}
}

 

HarmonyOS NEXT实战开发:触摸事件 当手指在组件上按下、滑动、抬起时触发。 阅读详情

相关推荐

鸿蒙5.0版开发:UI框架JS组件-容器组件(swiper)

滑动容器,提供切换子组件显示的能力。

m0_69424697的博客 1060

【鸿蒙next开发】ArkUI框架:ArkTS组件-触摸事件

本文详细介绍了鸿蒙5.0开发中的触摸事件处理机制,包括onTouch回调的使用、TouchEvent和TouchObject对象的属性及方法。

m0_73088370的博客 946

鸿蒙ArkTS声明式开发:跨平台支持列表【触摸事件】

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程,从而开设鸿蒙课程;企业纷纷跟进启动了鸿蒙研发。并且鸿蒙是完全具备无与伦比的机遇和潜力的;预计到年底将有 5,000 款的应用完成原生鸿蒙开发,未来将会支持 50 万款的应用。那么这么多的应用需要开发,也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长,学习鸿蒙势在必行!

m0_62167422的博客 1021

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(组件标识)

id为组件的唯一标识,在整个应用内唯一。

Androidbye的博客 1019

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:禁用控制)

ArkTS声明式开发(通用属性:禁用控制)

m0_64420071的博客 1564

鸿蒙Harmony应用开发—ArkTS声明式开发(触摸事件)

基于ArkTS声明式开发(触摸事件)

m0_64420071的博客 1920

【鸿蒙next开发】ArkUI框架:ArkTS组件-组件标识

本文介绍了鸿蒙5.0开发中的核心知识点和实战项目,重点讲解了组件标识id的使用及其相关接口。

m0_73088370的博客 868

鸿蒙Harmony应用开发—ArkTS-枚举说明

ArkTS-枚举说明

m0_64420071的博客 2692

【鸿蒙next开发】ArkUI框架:ArkTS组件-设置事件回调

本文介绍了鸿蒙HarmonyOS 5.0中UICommonEvent模块的事件回调设置方法,包括点击、触摸、显示/消失、按键、聚焦/失焦、悬停、鼠标、尺寸变化和可视区域变化等事件。

m0_73088370的博客 943

HarmonyOS NEXT实战(5.0 )ArkUI开发>键鼠输入事件

支持的鼠标事件包含通过外设鼠标、触控板触发的事件。

wui66655的博客 1361

SUMO从入门到精通:手把手教你用开源工具完成智能网联车仿真(附Python接口教程)

本文提供了一份SUMO开源交通仿真工具的完整实战指南,从环境搭建、基础仿真到Python接口TraCI的深度应用。重点讲解了如何利用SUMO的高度可定制性进行智能网联车仿真,包括实现动态信号优先等核心算法,并介绍了与网络仿真器集成以构建高保真车联网通信环境的方法。

weixin_28327051的博客 543

【鸿蒙next开发】ArkUI框架:ArkTS组件-QRCode

本文介绍了鸿蒙HarmonyOS中QRCode组件的使用.......

m0_73088370的博客 708

保姆级教程:用Dify+DeepSeek API打造你的私人股票分析助手(附完整配置流程)

本文提供了一份详细的教程,指导用户如何利用Dify低代码平台和DeepSeek API构建一个私人股票分析助手。内容涵盖从环境准备、Dify部署、DeepSeek模型配置,到设计智能体工作流和编写高效提示词的完整流程,旨在帮助投资者和开发者快速打造专属的AI投资分析工具。

weixin_29079671的博客 640

鸿蒙5.0开发进阶:UI框架-ArkTS组件(QRCode)

用于显示单个二维码的组件。

Androidbye的博客 869

免费测试国外大模型Claude 3.7 Sonnet API:无需api key(秘钥)

Claude 3.7 Sonnet是Anthropic公司推出的第三代Claude系列AI模型中的中规模版本(2024年发布),在性能与效率间实现平衡。该模型基于改进的Transformer架构,支持128K上下文窗口,擅长复杂推理、数学计算和创意写作,在GSM8K数学基准测试中准确率达92%。其采用"宪法AI"伦理框架,通过多轮对抗训练减少有害输出,同时新增多模态理解能力(可解析图片/图表内容)。Claude 3.7 Sonnet是Anthropic推出的高效轻量级大模型,主打快速响应与成本优化。

Explinks的博客 1500

79.ScottPlot的MVVM实现 C#例子 WPF例子

在你的 WPF 窗口的 XAML 文件中,定义一个,并将其Content属性绑定到 ViewModel 中的属性。这样可以将WpfPlot控件动态绑定到 ViewModel。

S13461120713的博客 2572

【鸿蒙next开发】ArkUI框架:ArkTS组件-触摸热区设置

本文介绍了鸿蒙5.0开发中的触摸热区设置功能,适用于支持点击、触摸和手势处理的组件。

m0_73088370的博客 1006

FPGA数字信号处理中定点数的舍入与饱和硬件实现详解

在数字信号处理(DSP)的硬件实现中,定点数运算是核心基础。由于硬件资源(如FPGA的DSP Slice)的位宽有限,连续的乘加运算会导致数据位宽膨胀,严重影响时序和资源利用率。为解决此问题,必须引入舍入(Rounding)和饱和(Saturation)机制。舍入通过对低位进行四舍五入,在可控的精度损失下缩减位宽;饱和则作为动态范围的守护者,防止数据溢出导致信号环绕失真,确保系统行为确定。这两种技术是算法在有限精度硬件上正确、高效运行的关键,广泛应用于滤波器、FFT等DSP模块以及通信、音频处理等场景。本文

weixin_30954817的博客 248

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(禁用控制)

组件是否可交互,可交互状态下响应点击事件、触摸事件、拖拽事件、按键事件、焦点事件和鼠标事件。

Androidbye的博客 479

YOLOv8集成EMA注意力机制YOLOv8完整教程 将EMA注意力机制集成到YOLOv8框架中

YOLOv8教程这篇文章介绍了如何将EMA(高效多尺度注意力)机制集成到YOLOv8目标检测框架中。YOLOv8 EMA注意力机制通过多尺度特征融合和高效计算,能够提升模型对关键特征的关注能力。文章详细解析了EMA的原理和结构设计,包括其核心组件和前向传播过程。此外,提供了完整的实现指南,包括环境准备、项目结构设置、EMA模块代码实现(包含分组处理、空间注意力计算和特征融合等关键步骤)。YOLOv8 YOLOv8 YOLOv8 YOLOv8 YOLOv8

FJN110的博客 928

《Java开发及前端最全面试题-Offer直通车》目录

Java开发是需求最广,工资高的细分领域,同时也是会的人最多,有的公司招1个Java开发,要面试几十甚至上百面试者,同时要求很高,要求通晓技术栈很多及很深深度。如果你正准备面试,想要脱颖而出,那么《Java开发及前端最全面试题-Offer直通车》是你的不二选择。本书汇集了多篇超过1万字的精华内容,无论是Java基础、数据库、SpringBoot和SpringCloud等必问的,还是前端、k8s等容器和虚拟化和大数据各类技术面试,本书都为你提供了最全面的试题和参考答案。

大模型大数据攻城狮的专栏 1180

鸿蒙5.0版开发:ArkUI框架开发-自定义渲染 (XComponent)

XComponent组件作为一种渲染组件,可用于EGL/OpenGLES和媒体数据写入..........

m0_73088370的博客 1662

在Simulink中构建感应电机的时滞补偿控制模型,并通过仿真验证不同补偿策略的有效性

核心优势Smith预估器可有效补偿已知时滞,提升系统稳定性。动态PID调整适用于时变时滞的初步补偿。扩展方向自适应时滞估计:结合Luenberger观测器实时估计时滞。鲁棒控制:引入H∞控制或滑模控制抑制参数不确定性。网络化时滞补偿:结合知识库[2]的网络延迟模型,实现端到端补偿。

amy_mhd的博客 190

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(触摸热区设置)

适用于支持通用点击事件、通用触摸事件、通用手势处理的组件。

Androidbye的博客 911

最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版

Part-E1-SDIO-Specification-Ver4.00-Final-120220.pdf:最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版,包括SDIO 接口的外设,SDIO 接口官方协议等。

VC中sqlite的使用

在VC中对sqlite的使用,实现数据库大批数据的快速插入,读取数据库中的数据在ListCtrl中显示

鸿蒙5.0开发进阶:ArkTS API UI界面(ArkUI)-NodeController

NodeController用于实现自定义节点的创建、显示、更新等操作的管理,并负责将自定义节点挂载到NodeContainer上。

Androidbye的博客 911

鸿蒙5.0开发进阶:JS组件-swiper

滑动容器,提供切换子组件显示的能力。

Androidbye的博客 1069
上一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(点击事件)
下一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(挂载卸载事件)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值