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

鸿蒙Harmony应用开发—ArkTS声明式开发(点击事件) 基于ArkTS的声明式开发(点击事件) 阅读详情

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


点击事件

组件被点击时触发的事件。

说明

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

onClick12+

onClick(event: Callback<ClickEvent>, distanceThreshold: number): T

点击动作触发该回调。

相较于原有onClick接口,新增distanceThreshold参数作为点击事件移动阈值,当手指的移动距离超出所设置的点击手势移动阈值时,点击手势识别失败。

对于点击时手指移动距离没有限制的场景,建议采用原有接口。若要求点击时手指在一定区域范围内,建议使用该接口。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

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

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

参数:

参数名类型必填说明
eventClickEvent是获得ClickEvent对象。
distanceThresholdnumber是

点击事件移动阈值。当设置的值小于等于0时,会被转化为默认值。

默认值:2^31-1

说明:

当手指的移动距离超出开发者预设的移动阈值时,点击识别失败。如果初始化为默认阈值时,手指移动超过组件热区范围,点击识别失败。

onClick

onClick(event: (event: ClickEvent) => void): T

点击动作触发该回调。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

参数:

参数名类型必填说明
eventClickEvent是获得ClickEvent对象。

返回值:

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

ClickEvent对象说明

继承于BaseEvent。

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

名称类型描述
xnumber

点击位置相对于被点击元素左边缘的X坐标。

单位:vp

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

ynumber

点击位置相对于被点击元素原始区域左上角的Y坐标。

单位:vp

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

target8+EventTarget

触发事件的元素对象显示区域。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

windowX10+number

点击位置相对于应用窗口左上角的X坐标。

单位:vp

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

windowY10+number

点击位置相对于应用窗口左上角的Y坐标。

单位:vp

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

displayX10+number

点击位置相对于应用屏幕左上角的X坐标。

单位:vp

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

displayY10+number

点击位置相对于应用屏幕左上角的Y坐标。

单位:vp

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

screenX(deprecated)number

点击位置相对于应用窗口左上角的X坐标。

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

screenY(deprecated)number

点击位置相对于应用窗口左上角的Y坐标。

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

preventDefault12+() => void

阻止默认事件。

说明: 该接口仅支持部分组件使用,当前支持组件:RichEditor。

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

EventTarget8+对象说明

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

名称参数类型描述
areaArea目标元素的区域信息。

示例

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

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

build() {
Column() {
Row({ space: 20 }) {
Button('Click').width(100).height(40)
.onClick((event?: ClickEvent) => {
if(event){
this.text = 'Click Point:' + '\n windowX:' + event.windowX + '\n windowY:' + event.windowY
+ '\n x:' + event.x + '\n y:' + event.y + '\ntarget:' + '\n component globalPos:('
+ event.target.area.globalPosition.x + ',' + event.target.area.globalPosition.y + ')\n width:'
+ event.target.area.width + '\n height:' + event.target.area.height + '\ntimestamp' + event.timestamp;
}
}, 20)
Button('Click').width(200).height(50)
.onClick((event?: ClickEvent) => {
if(event){
this.text = 'Click Point:' + '\n windowX:' + event.windowX + '\n windowY:' + event.windowY
+ '\n x:' + event.x + '\n y:' + event.y + '\ntarget:' + '\n component globalPos:('
+ event.target.area.globalPosition.x + ',' + event.target.area.globalPosition.y + ')\n width:'
+ event.target.area.width + '\n height:' + event.target.area.height + '\ntimestamp' + event.timestamp;
}
}, 20)
}.margin(20)

Text(this.text).margin(15)
}.width('100%')
}
}

鸿蒙5.0版开发:ArkTS组件-点击事件 组件被点击时触发的事件。 阅读详情

相关推荐

SAP SD核心流程解析:从销售订单到财务结算的实战指南

本文深入解析SAP SD模块从销售订单到财务结算的核心流程,重点剖析了销售订单中的行项目类别如何作为流程的“总开关”,决定了后续交货、开票及财务集成的走向。文章结合实战案例,详细拆解了正常销售、退货、第三方销售、寄售等典型流程的配置要点与国内化适配方案,并阐述了SD与财务模块集成的关键连接点,为顾问和用户提供了一份全面的实战指南。

weixin_29250403的博客 429

【鸿蒙软件开发】ArkTS通用事件

在我们的ArkTS中有一些通用的事件,他们在所有的组件中都可以用,所以我们需要来学习一下。获得更好的开发体验和效率!!!组件被点击时触发的事件。名称支持冒泡功能描述否点击动作触发该回调,event返回值见ClickEvent对象说明。从API version 9开始,该接口支持在ArkTS卡片中使用。组件被点击时触发的事件。名称支持冒泡功能描述是手指触摸动作触发该回调,event返回值见TouchEvent介绍。

m0_62599305的博客 3337

zynq 7010/020 AMP双核通信-Vitis2023/2024

在platform cpu1设置中添加;注意value中使用空格分开程序思路:比较简单。

weixin_43310175的博客 919

HarmonyOS开发(十二):ArkTS组件通用事件

不支持冒泡点击动作触发该回调,支持在卡片中使用ClickEvent对象说明触发事件的元素对象显示区域区域是一个Area类型数据。

advent86的专栏 5907

Cadence电路原理图全部变成黄色如何解决?

Cadence电路原理图全部变成黄色如何解决?现象:解决方法: 最近用cadence仿真锁相环,拷贝师哥的library后打开,发现schematic中全部变成了黄色,但可以正常修改元件参数,正常仿真。仅仅影响使用效果,看起来超级难受。 现象: 1.电路元件及连线全部变为黄色 2.可以正常修改参数,电路ADE仿真 如下图所示: 解决方法: 重新导入display.drf文件,步骤如下: tool——Display Resource Manager,截图如下 完成上述步骤,显示如下界面,选择Merge选项

virtuoso~晓晓 1万+

计算机控制液压同步顶升系统,PLC四点多点同步顶升系统,同步液压顶升系统

PLC同步顶升系统系统可分为5个部分:液压泵站、PLC计算机控制系统、液压终端、位移压力检测与人机界面操作系统,位移同步精度1mm,同步控制点数:4,8,12,16,20,40,80,99;产品特点:高速置零、低速顶升,升降速度可以任意控制;液压千斤顶内置式(或外置)位移、压力传感器、均载阀,保证了顶升系统在恶劣工作环境下的高可靠性;均载阀的过载保护功能,避免了多缸顶升时常见的胀缸事故;先进的进油...

weixin_30093045的博客 1435

鸿蒙next版开发:ArkTS组件点击事件详解

通过本文的介绍,你应该对如何在HarmonyOS 5.0中使用ArkTS处理点击事件有了基本的了解。点击事件是提升用户体验的关键,合理利用这些事件可以使你的应用更加生动和响应用户的操作。希望本文能够帮助你在开发过程中更好地利用ArkTS的点击事件机制。

小淼淼的博客 1808

Procedural modeling

What is procedural modeling? One content generation option is modeling buildings, plants, clouds, cities, and worlds using an underlying system of rules. 1 Procedural Modeling: Grammars A rule-based generative system loosely organized as: ...

qq_24505417的博客 712

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(颜色渐变)

设置组件的颜色渐变效果。

Androidbye的博客 1334

Eplan P8自动线号生成全攻略:从电位定义点到连接编号的完整流程

本文详细解析了Eplan P8自动线号生成的全流程,从电位定义点的创建配置到连接编号的标准化管理,帮助电气设计人员提升图纸规范性和工作效率。重点介绍了自动编号方案的定义与调整技巧,以及企业级标准化实施建议,是掌握Eplan P8自动线号功能的实用指南。

weixin_29254029的博客 510

手把手教你学Simulink--电动物流车预充电路控制及主继电器粘连检测电机负载仿真

摘要:本文基于Simulink仿真平台,研究了电动物流车预充电路控制策略及主继电器粘连检测技术。通过构建预充电路、主继电器检测及电机负载模型,分析了不同工况下的系统特性。研究表明,优化的预充控制策略可缩短预充时间至0.5秒内,降低电流峰值;主继电器粘连检测模型能准确识别故障;电机负载变化对系统性能具有显著影响。仿真结果验证了所提方法的有效性,为提升电动物流车安全性与可靠性提供了理论支持和技术参考。

MHD0815的博客 63

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

为组件绑定弹出式菜单,弹出式菜单以垂直列表形式显示菜单项,可通过长按、点击或鼠标右键触发。

Androidbye的博客 1193

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

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

设置组件的浮层。

Androidbye的博客 1208

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

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

自定义组件的走焦效果,可设置组件是否走焦和具体的走焦顺序,tab键或者方向键切换焦点。

Androidbye的博客 1326

廖雪峰Python教程[完整版]

廖雪峰的python教程整理的,已经排好版了,而且还是完整的,适合小白

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(栅格设置)

栅格布局的列宽、列间距由距离最近的GridContainer父组件决定。

Androidbye的博客 1140

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(形状裁剪)

用于对组件进行裁剪、遮罩处理。

Androidbye的博客 819

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

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

Androidbye的博客 1019

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

本文详细介绍了鸿蒙5.0开发中的点击事件处理,特别是onClick接口的使用及其在不同API版本中的变化。

m0_73088370的博客 1083

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

TextInput组件用于单行文本输入,支持多种属性和事件,如设置提示文本、文本内容、光标颜色、输入框类型等。

m0_73088370的博客 1643

鸿蒙5.0版开发:ArkUI框架开发-嵌入ArkTS组件

ArkUI在Native侧提供的能力作为ArkTS的子集...........

m0_73088370的博客 1320

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

设置组件是否可以响应拖拽事件。

Androidbye的博客 1210

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(绑定手势方法)

为组件绑定不同类型的手势事件,并设置事件的响应方法。

Androidbye的博客 909

【鸿蒙next开发】ArkUI框架:ArkTS组件-形状裁剪

本文详细讲解了clip、clipShape、mask和maskShape等接口的使用方法及其参数说明,并提供了从API版本7到12的更新和废弃信息。

m0_73088370的博客 1166

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

本文详细介绍了鸿蒙5.0开发中的SideBarContainer组件,该组件用于创建可显示和隐藏的侧边栏。

m0_73088370的博客 1114

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

本文详细说明了Circle的各种属性和配置选项,包括宽度/高度设置、填充颜色(fill)、透明度(fillOpacity)、边框属性(stroke)、虚线样式(strokeDashArray)等。

m0_73088370的博客 823
上一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面(ArkUI)-NodeController
下一篇: 鸿蒙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、付费专栏及课程。

余额充值