鸿蒙OpenHarmony【自定义手势判定】ArkTS组件通用属性

最新推荐文章于 2025-12-05 09:44:38 发布

原创

最新推荐文章于 2025-12-05 09:44:38 发布 · 477 阅读

CC 4.0 BY-SA版权

文章标签：

为组件提供自定义手势判定能力。开发者可根据需要，在手势识别期间，决定是否响应手势。

说明

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

onGestureJudgeBegin(callback: (gestureInfo: GestureInfo, event: BaseGestureEvent) => GestureJudgeResult): T

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

参数：

参数名	参数类型	必填	参数描述
callback	(gestureInfo: [GestureInfo], event: [BaseGestureEvent]) => [GestureJudgeResult]	是	给组件绑定自定义手势判定回调，当绑定到该组件的手势被接受时，会触发用户定义的回调来获取结果。

返回值：

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

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

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

名称	描述
CONTINUE	不影响系统手势判定流程。
REJECT	对于用户自定义的手势判定结果为失败。

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

名称	类型	描述
tag	string	手势标记。说明：如果未设置事件标识tag属性的情况下，此处tag不返回或者返回undefined。
type	[GestureControl.GestureType]	手势类型。说明：当手势为未暴露类型的系统内置手势事件时，type的值为-1。
isSystemGesture	boolean	判断当前手势是否是组件自带的手势。默认值：false