设置组件绑定的手势

用于设置组件绑定的手势。可以通过UIGestureEvent对象调用其接口添加或删除手势。

说明：

本模块首批接口从API version 12开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。

UIGestureEvent

用于设置组件绑定的手势。

addGesture

addGesture(gesture: GestureHandler<T>, priority?: GesturePriority, mask?: GestureMask): void

添加手势。

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

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

参数：

参数名	类型	必填	说明
gesture	GestureHandler<T>	是	手势处理器对象。
priority	GesturePriority	否	绑定手势的优先级。 默认值：GesturePriority.NORMAL
mask	GestureMask	否	事件响应设置。 默认值：GestureMask.Normal

addParallelGesture

addParallelGesture(gesture: GestureHandler<T>, mask?: GestureMask): void

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

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

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

参数：

参数名	类型	必填	说明
gesture	GestureHandler<T>	是	手势处理器对象。
mask	GestureMask	否	事件响应设置。 默认值：GestureMask.Normal

removeGestureByTag

removeGestureByTag(tag: string): void

移除该组件上通过modifier绑定的设置为指定标志的手势。

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

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

参数：

参数名	类型	必填	说明
tag	string	是	手势处理器标志。

clearGestures

clearGestures(): void

清除该组件上通过modifier绑定的所有手势。

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

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

GestureHandler<T>

手势对象的基础类型。

tag

tag(tag: string): T

设置手势处理器的标志。

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

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

参数：

名称	类型	必填	描述
tag	string	是	设置手势处理器标志。

allowedTypes¹⁴⁺

allowedTypes(types: Array<SourceTool>): T

设置手势处理器所支持的事件输入源。

原子化服务API： 从API version 14开始，该接口支持在原子化服务中使用。

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

参数：

名称	类型	必填	描述
types	Array<SourceTool>	是	设置手势处理器所支持的事件输入源。

TapGestureHandler

点击手势处理器对象类型。

constructor

constructor(options?: TapGestureHandlerOptions)

构造函数。

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

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

参数：

参数名	类型	必填	说明
options	TapGestureHandlerOptions	否	点击手势处理器配置参数。

onAction

onAction(event: Callback<GestureEvent>): TapGestureHandler

Tap手势识别成功回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Tap手势识别成功回调。

返回值：

类型	说明
TapGestureHandler	返回当前点击手势处理器对象。

TapGestureHandlerOptions

点击手势处理器配置参数。

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

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

属性	类型	必填	描述
count	number	否	识别的连续点击次数。当设置的值小于1或不设置时，会被转化为默认值。 默认值：1 说明： 1. 当配置多击时，上一次的最后一根手指抬起和下一次的第一根手指按下的超时时间为300毫秒。 2. 当上次点击的位置与当前点击的位置距离超过60vp时，手势识别失败。
fingers	number	否	触发点击的手指数，最小为1指， 最大为10指。当设置小于1的值或不设置时，会被转化为默认值。 默认值：1 说明： 1. 当配置多指时，第一根手指按下后300毫秒内未有足够的手指数按下，手势识别失败，第一根手指抬起后300毫秒内未有足够的手指抬起，手势识别失败。 2. 实际点击手指数超过配置值，手势识别成功。
isFingerCountLimited15+	boolean	否	是否检查触摸屏幕的手指数量。true表示检查触摸屏幕的手指数量，false表示不检查触摸屏幕的手指数量。如果触摸手指的数量不等于设置的触发点击的手指数（即上述fingers参数），那么该手势识别失败。 在多击事件中（上述count参数大于1），需要每一次点击的手指数都等于设置的触发点击的手指数，否则该手势识别失败。 默认值：false

LongPressGestureHandler

长按手势处理器对象类型。

constructor

constructor(options?: LongPressGestureHandlerOptions)

构造函数。

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

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

参数：

参数名	类型	必填	说明
options	LongPressGestureHandlerOptions	否	长按手势处理器配置参数。

onAction

onAction(event: Callback<GestureEvent>): LongPressGestureHandler

LongPress手势识别成功回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	LongPress手势识别成功回调。

返回值：

类型	说明
LongPressGestureHandler	返回当前长按手势处理器对象。

onActionEnd

onActionEnd(event: Callback<GestureEvent>): LongPressGestureHandler

LongPress手势识别成功，最后一根手指抬起后触发回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	LongPress手势识别成功，最后一根手指抬起后触发回调。

返回值：

类型	说明
LongPressGestureHandler	返回当前长按手势处理器对象。

onActionCancel

onActionCancel(event: Callback<void>): LongPressGestureHandler

LongPress手势识别成功，接收到触摸取消事件触发回调。不返回手势事件信息。

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

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

参数：

参数名	类型	必填	说明
event	Callback<void>	是	LongPress手势识别成功，接收到触摸取消事件触发回调。不返回手势事件信息。

返回值：

类型	说明
LongPressGestureHandler	返回当前长按手势处理器对象。

onActionCancel¹⁸⁺

onActionCancel(event: Callback<GestureEvent>): LongPressGestureHandler

LongPress手势识别成功，接收到触摸取消事件触发回调。与onActionCancel接口相比，此接口返回手势事件信息。

原子化服务API： 从API version 18开始，该接口支持在原子化服务中使用。

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	LongPress手势识别成功，接收到触摸取消事件触发回调。返回手势事件信息。

返回值：

类型	说明
LongPressGestureHandler	返回当前长按手势处理器对象。

LongPressGestureHandlerOptions

长按手势处理器配置参数。

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

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

属性	类型	必填	描述
fingers	number	否	触发长按的最少手指数，最小为1指， 最大取值为10指。 默认值：1 说明： 手指按下后若发生超过15px的移动，则判定当前长按手势识别失败。
repeat	boolean	否	是否连续触发事件回调。true表示为连续触发事件回调，false表示不连续触发事件回调。 默认值：false
duration	number	否	触发长按的最短时间，单位为毫秒（ms）。 默认值：500 说明： 取值范围：[0, +∞)，设置小于等于0时，按照默认值500处理。
isFingerCountLimited15+	boolean	否	是否检查触摸屏幕的手指数量。true表示检查触摸屏幕的手指数量，false表示不检查触摸屏幕的手指数量。若触摸屏幕的手指的数量不等于设置的触发长按的最少手指数（即上述fingers参数），手势识别将失败。 对于已成功识别的手势，后续触摸屏幕的手指数变化，将不触发repeat事件（若触摸屏幕的手指数恢复到设置的触发长按的最少手指数时，可以触发onAction事件），但可以触发onActionEnd事件。 默认值：false

PanGestureHandler

拖动手势处理器对象类型。

constructor

constructor(options?: PanGestureHandlerOptions)

构造函数。

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

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

参数：

参数名	类型	必填	说明
options	PanGestureHandlerOptions	否	拖动手势处理器配置参数。

onActionStart

onActionStart(event: Callback<GestureEvent>): PanGestureHandler

Pan手势识别成功回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Pan手势识别成功回调。

返回值：

类型	说明
PanGestureHandler	返回当前拖动手势处理器对象。

onActionUpdate

onActionUpdate(event: Callback<GestureEvent>): PanGestureHandler

Pan手势移动过程中回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Pan手势移动过程中回调。 fingerList为多根手指时，该回调监听每次只会更新一根手指的位置信息。

返回值：

类型	说明
PanGestureHandler	返回当前拖动手势处理器对象。

onActionEnd

onActionEnd(event: Callback<GestureEvent>): PanGestureHandler

Pan手势识别成功，手指抬起后触发回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Pan手势识别成功，手指抬起后触发回调。

返回值：

类型	说明
PanGestureHandler	返回当前拖动手势处理器对象。

onActionCancel

onActionCancel(event: Callback<void>): PanGestureHandler

Pan手势识别成功，接收到触摸取消事件触发回调。不返回手势事件信息。

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

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

参数：

参数名	类型	必填	说明
event	Callback<void>	是	Pan手势识别成功，接收到触摸取消事件触发回调。不返回手势事件信息。

返回值：

类型	说明
PanGestureHandler	返回当前拖动手势处理器对象。

onActionCancel¹⁸⁺

onActionCancel(event: Callback<GestureEvent>): PanGestureHandler

Pan手势识别成功，接收到触摸取消事件触发回调。与onActionCancel接口相比，此接口返回手势事件信息。

原子化服务API： 从API version 18开始，该接口支持在原子化服务中使用。

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Pan手势识别成功，接收到触摸取消事件触发回调。返回手势事件信息。

返回值：

类型	说明
PanGestureHandler	返回当前拖动手势处理器对象。

PanGestureHandlerOptions

拖动手势处理器配置参数。

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

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

属性	类型	必填	描述
fingers	number	否	用于指定触发拖动的最少手指数，最小为1指， 最大取值为10指。 默认值：1 取值范围：[1,10] 说明： 当设置的值小于1或不设置时，会被转化为默认值。
direction	PanDirection	否	用于指定触发拖动的手势方向，此枚举值支持逻辑与(&)和逻辑或（|）运算。 默认值：PanDirection.All
distance	number	否	用于指定触发拖动手势事件的最小拖动距离，单位为vp。 手写笔默认值：8，其余输入源默认值：5 说明： Tabs组件滑动与该拖动手势事件同时存在时，可将distance值设为1，使拖动更灵敏，避免造成事件错乱。 取值范围：[0, +∞)，当设定的值小于0时，按默认值处理。 从API version 19开始，手写笔默认值为8，单位为vp。
isFingerCountLimited15+	boolean	否	是否检查触摸屏幕的手指数量。true表示检查触摸屏幕的手指数量，false表示不检查触摸屏幕的手指数量。若触摸屏幕的手指数量不等于设置的触发滑动的最少手指数（即上述fingers参数），手势将不会被识别。只有当触摸屏幕的手指数等于设置的触发滑动的最少手指数，并且滑动距离达到阈值时，
手势才能被成功识别。 对于已成功识别的手势，后续改变触摸屏幕的手指数量不会引发onActionUpdate事件，但可以触发onActionEnd事件。 默认值：false
distanceMap19+	Map<SourceTool, number>	否	用于指定不同输入源触发拖动手势事件的最小拖动距离，单位为vp。 手写笔默认值：8，其余输入源默认值：5 取值范围：[0, +∞)，当设定的值小于0时，按默认值处理。

SwipeGestureHandler

滑动手势处理器对象类型。

constructor

constructor(options?: SwipeGestureHandlerOptions)

构造函数。

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

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

参数：

参数名	类型	必填	说明
options	SwipeGestureHandlerOptions	否	滑动手势处理器配置参数。

onAction

onAction(event: Callback<GestureEvent>): SwipeGestureHandlerOptions

Swipe手势识别成功回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Swipe手势识别成功回调。

返回值：

类型	说明
SwipeGestureHandler	返回当前滑动手势处理器对象。

SwipeGestureHandlerOptions

滑动事件处理器配置参数。

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

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

属性	类型	必填	描述
fingers	number	否	触发滑动的最少手指数，默认为1，最小为1指，最大为10指。 默认值：1
direction	SwipeDirection	否	触发滑动手势的滑动方向。 默认值：SwipeDirection.All
speed	number	否	识别滑动的最小速度。 默认值：100VP/s 说明： 当滑动速度的值小于等于0时，会被转化为默认值。
isFingerCountLimited15+	boolean	否	是否检查触摸屏幕的手指数量。true表示检查触摸屏幕的手指数量，false表示不检查触摸屏幕的手指数量。如果触摸手指的数量不等于设置的触发滑动的最少手指数（即上述fingers参数），手势识别将失败。 默认值：false

PinchGestureHandler

捏合手势处理器对象类型。

constructor

constructor(options?: PinchGestureHandlerOptions)

构造函数。

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

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

参数：

参数名	类型	必填	说明
options	PinchGestureHandlerOptions	否	捏合手势处理器配置参数。

onActionStart

onActionStart(event: Callback<GestureEvent>): PinchGestureHandler

Pinch手势识别成功回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Pinch手势识别成功回调。

返回值：

类型	说明
PinchGestureHandler	返回当前捏合手势处理器对象。

onActionUpdate

onActionUpdate(event: Callback<GestureEvent>): PinchGestureHandler

Pinch手势移动过程中回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Pinch手势移动过程中回调。

返回值：

类型	说明
PinchGestureHandler	返回当前捏合手势处理器对象。

onActionEnd

onActionEnd(event: Callback<GestureEvent>): PinchGestureHandler

Pinch手势识别成功，手指抬起后触发回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Pinch手势识别成功，手指抬起后触发回调。

返回值：

类型	说明
PinchGestureHandler	返回当前捏合手势处理器对象。

onActionCancel

onActionCancel(event: Callback<void>): PinchGestureHandler

Pinch手势识别成功，接收到触摸取消事件触发回调。不返回手势事件信息。

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

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

参数：

参数名	类型	必填	说明
event	Callback<void>	是	Pinch手势识别成功，接收到触摸取消事件触发回调。不返回手势事件信息。

返回值：

类型	说明
PinchGestureHandler	返回当前捏合手势处理器对象。

onActionCancel¹⁸⁺

onActionCancel(event: Callback<GestureEvent>): PinchGestureHandler

Pinch手势识别成功，接收到触摸取消事件触发回调。与onActionCancel接口相比，此接口返回手势事件信息。

原子化服务API： 从API version 18开始，该接口支持在原子化服务中使用。

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Pinch手势识别成功，接收到触摸取消事件触发回调。返回手势事件信息。

返回值：

类型	说明
PinchGestureHandler	返回当前捏合手势处理器对象。

PinchGestureHandlerOptions

捏合手势处理器配置参数。

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

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

属性	类型	必填	描述
fingers	number	否	触发捏合的最少手指数, 最小为2指，最大为5指。 默认值：2 触发手势手指可以多于fingers数目，但只有先落下的与fingers相同数目的手指参与手势计算。
distance	number	否	最小识别距离，单位为vp。 默认值：5 说明： 当识别距离的值小于等于0时，会被转化为默认值。
isFingerCountLimited15+	boolean	否	是否检查触摸屏幕的手指数量。true表示检查触摸屏幕的手指数量，false表示不检查触摸屏幕的手指数量。若触摸屏幕的手指数量不等于设置的触发捏合的最少手指数（即上述fingers参数），手势将不会被识别。只有当触摸屏幕的手指数等于设置的触发捏合手势的最小手指数，并且滑动距离满足阈值要求时，手势才能被成功识别（只有先落下的两根手指参与手势计算，若抬起其中的一个，手势识别失败）。对于已经成功识别的手势，后续改变触摸屏幕的手指数量，将不会触发onActionUpdate事件，但可以触发onActionEnd事件。 默认值：false

RotationGestureHandler

旋转手势处理器对象类型。

constructor

constructor(options?: RotationGestureHandlerOptions)

构造函数。

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

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

参数：

参数名	类型	必填	说明
options	RotationGestureHandlerOptions	否	旋转手势处理器配置参数。

onActionStart

onActionStart(event: Callback<GestureEvent>): RotationGestureHandler

Rotation手势识别成功回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Rotation手势识别成功回调。

返回值：

类型	说明
RotationGestureHandler	返回当前旋转手势处理器对象。

onActionUpdate

onActionUpdate(event: Callback<GestureEvent>): RotationGestureHandler

Rotation手势移动过程中回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Rotation手势移动过程中回调。

返回值：

类型	说明
RotationGestureHandler	返回当前旋转手势处理器对象。

onActionEnd

onActionEnd(event: Callback<GestureEvent>): RotationGestureHandler

Rotation手势识别成功，手指抬起后触发回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Rotation手势识别成功，手指抬起后触发回调。

返回值：

类型	说明
RotationGestureHandler	返回当前旋转手势处理器对象。

onActionCancel

onActionCancel(event: Callback<void>): RotationGestureHandler

Rotation手势识别成功，接收到触摸取消事件触发回调。不返回手势事件信息。

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

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

参数：

参数名	类型	必填	说明
event	Callback<void>	是	Rotation手势识别成功，接收到触摸取消事件触发回调。不返回手势事件信息。

返回值：

类型	说明
RotationGestureHandler	返回当前旋转手势处理器对象。

onActionCancel¹⁸⁺

onActionCancel(event: Callback<GestureEvent>): RotationGestureHandler

Rotation手势识别成功，接收到触摸取消事件触发回调。与onActionCancel相比，此接口返回手势事件信息。

原子化服务API： 从API version 18开始，该接口支持在原子化服务中使用。

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

参数：

参数名	类型	必填	说明
event	Callback<GestureEvent>	是	Rotation手势识别成功，接收到触摸取消事件触发回调。返回手势事件信息。

返回值：

类型	说明
RotationGestureHandler	返回当前旋转手势处理器对象。

RotationGestureHandlerOptions

旋转手势处理器配置参数。

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

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

属性	类型	必填	描述
fingers	number	否	触发旋转的最少手指数, 最小为2指，最大为5指。 默认值：2 触发手势时手指数量可以多于fingers参数值，但仅最先落下的两指参与手势计算。
angle	number	否	触发旋转手势的最小改变度数，单位为deg。 默认值：1 说明： 当改变度数的值小于等于0或大于360时，会被转化为默认值。
isFingerCountLimited15+	boolean	否	是否检查触摸屏幕的手指数量。true表示检查触摸屏幕的手指数量，false表示不检查触摸屏幕的手指数量。若触摸屏幕的手指数量不等于设置的触发旋转的最少手指数（即上述fingers参数），手势将不会被识别。只有当触摸屏幕的手指数等于设置的触发旋转的最少手指数，并且滑动距离达到阈值时，手势才能被成功识别（只有先落下的两根手指参与手势计算，若抬起其中的一个，手势识别失败）。 对于已成功识别的手势，后续改变触摸屏幕的手指数量，不会触发onActionUpdate事件，但可以触发onActionEnd事件。 默认值：false

GestureGroupHandler

手势组处理器对象类型。

constructor

constructor(options?: GestureGroupGestureHandlerOptions)

构造函数。

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

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

参数：

参数名	类型	必填	说明
options	GestureGroupGestureHandlerOptions	否	手势组处理器配置参数。

onCancel

onCancel(event: Callback<void>): GestureGroupHandler

Rotation手势识别成功，接收到触摸取消事件触发回调。

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

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

参数：

参数名	类型	必填	说明
event	Callback<void>	是	顺序组合手势（GestureMode.Sequence）取消后触发回调。

返回值：

类型	说明
GestureGroupHandler	返回当前手势组处理器对象。

GestureGroupGestureHandlerOptions

手势组处理器配置参数。

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

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

属性	类型	必填	描述
mode	GestureMode	是	设置组合手势识别模式。 默认值：GestureMode.Sequence
gestures	GestureHandler<TapGestureHandler |LongPressGestureHandler |PanGestureHandler |SwipeGestureHandler |PinchGestureHandler |RotationGestureHandler |GestureGroupHandler>[]	是	手势组下需要包含的手势。 说明： 当需要为一个组件同时添加单击和双击手势时，可在组合手势中添加两个TapGesture，需要双击手势在前，单击手势在后，否则不生效。

GesturePriority枚举说明

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

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

名称	描述
NORMAL	普通优先级手势。
PRIORITY	高优先级手势。

示例

见动态手势设置。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙图像AI分析错误码

harmony 鸿蒙ArcButton

harmony 鸿蒙ArcSlider

harmony 鸿蒙Chip

harmony 鸿蒙ChipGroup

harmony 鸿蒙ComposeListItem

harmony 鸿蒙ComposeTitleBar

harmony 鸿蒙advanced.Counter

harmony 鸿蒙弹出框 (Dialog)

harmony 鸿蒙DialogV2