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

鸿蒙5.0版开发:ArkTS组件通用属性(绑定手势方法) 为组件绑定不同类型的手势事件,并设置事件的响应方法。 阅读详情

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


绑定手势方法

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

说明

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

绑定手势识别

通过如下属性给组件绑定手势识别,手势识别成功后可以通过事件回调通知组件。

可以通过触摸热区指定可识别手势的区域。

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

名称参数类型默认值描述
gesture

gesture: GestureType,

mask?: GestureMask

gesture: -,

mask: GestureMask.Normal

绑定手势。

- gesture: 绑定的手势类型。

- mask: 事件响应设置。

priorityGesture

gesture: GestureType,

mask?: GestureMask

gesture: -,

mask: GestureMask.Normal

绑定优先识别手势。

- gesture: 绑定的手势类型。

- mask: 事件响应设置。

1、默认情况下,子组件优先识别通过gesture绑定的手势,当父组件配置priorityGesture时,父组件优先识别priorityGesture绑定的手势。

2、长按手势时,设置触发长按的最短时间小的组件会优先响应,会忽略priorityGesture设置。

parallelGesture

gesture: GestureType,

mask?: GestureMask

gesture: -,

mask: GestureMask.Normal

绑定可与子组件手势同时触发的手势。

- gesture: 绑定的手势类型。

- mask: 事件响应设置。

手势事件为非冒泡事件。父组件设置parallelGesture时,父子组件相同的手势事件都可以触发,实现类似冒泡效果。

GestureType

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

名称描述
TapGesture点击手势,支持单次点击、多次点击识别。
LongPressGesture长按手势。
PanGesture平移手势,滑动最小距离为5vp时识别成功。
PinchGesture捏合手势。
RotationGesture旋转手势。
SwipeGesture滑动手势,滑动最小速度为100vp/s时识别成功。
GestureGroup手势识别组,多种手势组合为复合手势,支持连续识别、并行识别和互斥识别。

GestureMask枚举说明

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

名称描述
Normal不屏蔽子组件的手势,按照默认手势识别顺序进行识别。
IgnoreInternal屏蔽子组件的手势,包括子组件上系统内置的手势,如子组件为List组件时,内置的滑动手势同样会被屏蔽。 若父子组件区域存在部分重叠,则只会屏蔽父子组件重叠的部分。

响应手势事件

组件通过手势事件绑定不同GestureType的手势对象,各手势对象在响应手势操作的事件回调中提供手势相关信息。下面通过TapGesture手势对象的onAction事件响应点击事件,获取事件相关信息。其余手势对象的事件定义见各个手势对象章节。 若需绑定多种手势请使用 组合手势。

TapGesture事件说明

名称功能描述
onAction((event:GestureEvent) => void)Tap手势识别成功回调。

GestureEvent对象说明

继承于BaseEvent。

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

名称类型描述
repeatboolean是否为重复触发事件,用于LongPressGesture手势触发场景。
offsetXnumber手势事件偏移量X,单位为vp,用于PanGesture手势触发场景,从左向右滑动offsetX为正,反之为负。
offsetYnumber手势事件偏移量Y,单位为vp,用于PanGesture手势触发场景,从上向下滑动offsetY为正,反之为负。
anglenumber

用于RotationGesture手势触发场景时,表示旋转角度。

用于SwipeGesture手势触发场景时,表示滑动手势的角度,即两根手指间的线段与水平方向的夹角变化的度数。

说明:

角度计算方式:滑动手势被识别到后,连接两根手指之间的线被识别为起始线条,随着手指的滑动,手指之间的线条会发生旋转,根据起始线条两端点和当前线条两端点的坐标,使用反正切函数分别计算其相对于水平方向的夹角,最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。以起始线条为坐标系,顺时针旋转为0到180度,逆时针旋转为-180到0度。

scalenumber缩放比例,用于PinchGesture手势触发场景。
pinchCenterXnumber捏合手势中心点的x轴坐标,单位为vp,用于PinchGesture手势触发场景。
pinchCenterYnumber捏合手势中心点的y轴坐标,单位为vp,用于PinchGesture手势触发场景。
speed8+number滑动手势速度,即所有手指相对当前组件元素原始区域滑动的平均速度,单位为vp/秒,用于SwipeGesture手势触发场景。
fingerList8+FingerInfo[]

输入源为触屏产生的手势,fingerList中会包含触发事件的所有触点信息;由鼠标发起的手势,fingerList中只会有一条记录;触摸板的事件大类与鼠标一致,所以由触摸板发起的手势,fingerList只会携带一条记录。

说明:

手指索引编号与位置对应,即fingerList[index]的id为index。先按下且未参与当前手势触发的手指在fingerList中对应位置为空。

velocityX10+number用于PanGesture手势中,获取当前手势的x轴方向速度。坐标轴原点为屏幕左上角,分正负方向速度,从左往右为正,反之为负。单位为vp/s。
velocityY10+number用于PanGesture手势中,获取当前手势的y轴方向速度。坐标轴原点为屏幕左上角,分正负方向速度,从上往下为正,反之为负。单位为vp/s。
velocity10+number用于PanGesture手势中,获取当前手势的主方向速度。为xy轴方向速度的平方和的算术平方根。单位为vp/s。

SourceType枚举说明

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

名称描述
Unknown未知设备。
Mouse鼠标。
TouchScreen触摸屏。

FingerInfo对象说明8+

名称类型描述
idnumber

手指的索引编号。

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

globalXnumber

相对于应用窗口左上角的x轴坐标,单位为vp。

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

globalYnumber

相对于应用窗口左上角的y轴坐标,单位为vp。

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

localXnumber

相对于当前组件元素原始区域左上角的x轴坐标,单位为vp。

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

localYnumber

相对于当前组件元素原始区域左上角的y轴坐标,单位为vp。

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

displayX12+number

相对于屏幕左上角的x轴坐标,单位为vp。

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

displayY12+number

相对于屏幕左上角的y轴坐标,单位为vp。

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

SourceTool枚举说明9+

名称描述
Unknown

未知输入源。

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

Finger

手指输入。

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

Pen

手写笔输入。

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

Mouse12+

鼠标输入。

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

Touchpad12+

触控板输入。触控板单指输入被视为鼠标输入操作。

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

Joystick12+

手柄输入。

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

示例

该示例通过配置priorityGesture和parallelGesture分别实现了父组件优先识别手势和父子组件同时触发手势。

// xxx.ets
@Entry
@Component
struct GestureSettingsExample {
  @State priorityTestValue: string = ''
  @State parallelTestValue: string = ''

  build() {
    Column() {
      Column() {
        Text('TapGesture:' + this.priorityTestValue).fontSize(28)
          .gesture(
            TapGesture()
              .onAction((event: GestureEvent) => {
                this.priorityTestValue += '\nText'
              }))
      }
      .height(200)
      .width(250)
      .padding(20)
      .margin(20)
      .border({ width: 3 })
      // 设置为priorityGesture时,点击文本会忽略Text组件的TapGesture手势事件,优先识别父组件Column的TapGesture手势事件
      .priorityGesture(
        TapGesture()
          .onAction((event: GestureEvent) => {
            this.priorityTestValue += '\nColumn'
          }), GestureMask.IgnoreInternal)

      Column() {
        Text('TapGesture:' + this.parallelTestValue).fontSize(28)
          .gesture(
            TapGesture()
              .onAction((event: GestureEvent) => {
                this.parallelTestValue += '\nText'
              }))
      }
      .height(200)
      .width(250)
      .padding(20)
      .margin(20)
      .border({ width: 3 })
      // 设置为parallelGesture时,点击文本会同时触发子组件Text与父组件Column的TapGesture手势事件
      .parallelGesture(
        TapGesture()
          .onAction((event: GestureEvent) => {
            this.parallelTestValue += '\nColumn'
          }), GestureMask.Normal)
    }
  }
}

python实现手势识别 python实现手势识别(入门) 使用open-cv实现简单的手势识别 1.获取视频(摄像头) 2.肤色检测 3.轮廓提取 最终实现结果 阅读详情

相关推荐

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:LongPressGesture)

ArkTS声明式开发-基础手势:LongPressGesture

m0_64420071的博客 2016

用户手势检测-GestureDetector使用详解

前言:今天终于可以正常上班了,阿里的百技真的真的太累了,作为队长,不仅要考虑到每一个人的感受,而且要最大程度地使大家团结起来,共同完成一个任务,四天的时间,14个人的小组完成一个系统,我们队最终是第一个完成的,他们真的很厉害,周六周日都还在加班做,我真的很感动,今天有些同学要坐飞机回京了,很不舍,一周的并肩奋战,使我们一生在一起,小伙伴们,来日再聚! 一、概述 当用户触摸屏幕的时候,会产...

启舰 9万+

鸿蒙5.0版开发:ArkTS组件-自定义手势判定

为组件提供自定义手势判定能力。

m0_69424697的博客 1100

HarmonyOS学习笔记——ArkUI框架体系、HML基础组件、HML高级组件

ArkUI框架体系、HML基础组件、HML高级组件

2401_85302533的博客 2145

鸿蒙Harmony应用开发—ArkTS声明式开发(手势处理:绑定手势方法)

ArkTS声明式开发-手势处理:绑定手势方法

m0_64420071的博客 2078

鸿蒙NEXT开发:ArkTS组件-手势处理(自定义手势判定)

为组件提供自定义手势判定能力。

ZPYQAQ的博客 1001

鸿蒙ArkTS声明式开发:跨平台支持列表【TapGesture】 基础手势

支持单击、双击和多次点击事件的识别。从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

2401_82772199的博客 377

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:DatePicker)

ArkTS声明式开发(基础手势:DatePicker)

m0_64420071的博客 1893

【鸿蒙next开发】ArkUI框架:ArkTS组件-绑定手势方法

本文详细介绍了鸿蒙5.0开发中的手势绑定与识别技术,包括如何为组件绑定不同类型的手势事件,并设置事件的响应方法。

m0_73088370的博客 893

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:PanGesture)

ArkTS声明式开发(基础手势:PanGesture)

m0_64420071的博客 2120

Cisco Packet Tracer 7.3免登录技巧:3种方法快速跳过注册界面(附详细截图)

本文针对Cisco Packet Tracer 7.3启动时遇到的登录界面问题,提供了三种合法高效的解决方案。详细介绍了如何利用官方访客模式快速启动、注册思科账号实现一劳永逸登录,以及通过调整本地安装配置优化启动流程,帮助网络学习者与备考者绕过繁琐步骤,快速进入实验环境。

weixin_29305337的博客 745

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

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

Androidbye的博客 1193

介绍七种常见还危险的病毒(带样本)

简介:能够感染用户计算机bai系统中的.exe、.dll和.html文件,将自身加密以后缀加到目标文件中。样本(源文件):https://wwx.lanzoux.com/iJx4njrpz1c / https://wwx.lanzoui.com/iYRNLwd8ldc。英文名称:Virus.Win32.Viking.A(标准) / Worm.Win32.Fujack.A(标准)英文名称:Net-Worm.Win32.Blaster.A(标准)/ Lovesan.A/ Msblast.A。

2301_78858007的博客 8534

【鸿蒙next开发】ArkUI框架:ArkTS组件-设置组件绑定的手势

本文详细介绍了鸿蒙5.0开发中的手势处理功能,涵盖了从API version 12开始支持的核心接口和手势处理器类型。

m0_73088370的博客 968

从零到一:TI AWR1843 Boost EVM与DCA1000 EVM的ADC数据采集实战指南

本文详细介绍了TI AWR1843 Boost EVM与DCA1000 EVM的ADC数据采集实战指南,涵盖硬件连接、软件配置、固件烧录、雷达参数设置及数据处理等关键步骤。通过MATLAB等工具,开发者可高效实现毫米波雷达数据采集,适用于自动驾驶、工业检测等领域。

weixin_29001327的博客 967

从MRF8P9040N数据手册到ADS仿真:手把手教你搞定LDMOS功放设计(附完整模型下载)

本文详细解析了MRF8P9040N LDMOS功率放大器的数据手册关键参数,并提供了在ADS中进行仿真的完整指南。从模型导入、直流工作点验证到负载牵引与阻抗匹配设计,逐步指导工程师完成高效功放设计。文章还包含调试技巧和常见问题解决方案,帮助优化射频功放性能。

weixin_27015733的博客 493

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

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

Androidbye的博客 819

你的小龙虾 OpenClaw 还很笨?快给它装上这几个核心技能(OpenClaw 必装skills整理)

🦞 刚装小龙虾OpenClaw? 本文分享一些OpenClaw必装技能,从视觉理解到智能学习,让它从“会聊天”变“会干活” 🚀

XiaoqiangClub的博客 872

【鸿蒙next开发】ArkUI框架:ArkTS组件-自定义手势判定

本文详细介绍了鸿蒙5.0开发中的自定义手势判定功能,重点讲解了onGestureJudgeBegin接口的使用方法及其参数配置。

m0_73088370的博客 893

【灰度共生矩阵(GLCM)原理及代码实现】

文章主旨详细介绍灰度共生矩阵(Gray-Level Co-occurrence Matrix, GLCM)的生成原理、核心特征量及其在图像纹理分析中的应用,并提供了可运行的Python代码实现。该网页是一篇理论结合实践的优秀技术文章。它不仅清晰地解释了GLCM这一经典纹理分析工具背后的数学原理,还提供了完整、可复现的代码,非常适合计算机视觉或图像处理领域的学习者和开发者入门并实践灰度共生矩阵。读者可以通过运行代码来直观理解GLCM如何工作,并提取图像的纹理特征。

blotemj.blog.youkuaiyun.com 180

微信小程序数据采集实战:抓包+接口分析+动态数据全流程

微信小程序爬虫虽然比普通网页爬虫复杂,但只要掌握了正确的方法,其实并没有想象中那么难。核心思路就是:先绕过证书校验抓包,然后反编译小程序找到加密逻辑,最后用Python模拟相同的加密和解密过程。需要特别提醒的是,本文仅供技术研究使用。请遵守《网络安全法》和相关法律法规,不要爬取他人的敏感数据,不要将爬虫技术用于非法用途。尊重他人的知识产权和数据安全,才能让技术发挥真正的价值。

专注于Python爬虫开发,分享爬虫技巧、项目实战与反爬经验,使用Scrapy、BeautifulSoup等工具,解决数据抓取难题。 1096

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

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

m0_73088370的博客 1166

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

【鸿蒙next开发】ArkUI框架:ArkTS组件-手势拦截增强

本文详细介绍了鸿蒙5.0开发中的手势拦截功能及其相关API的使用。

m0_73088370的博客 1012

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

IDEA的使用指南

IDEA基于java的使用手册,可以最快速的上手,在使用中不断的丰富自己的使用技巧.

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

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

m0_73088370的博客 1643

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值