## 概述

PhonePC/2in1TabletTVWearable

提供NativeGesture接口的类型定义。

**引用文件：** <arkui/native\_gesture.h>

**库：** libace\_ndk.z.so

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

**起始版本：** 12

**相关模块：** [ArkUI\_NativeModule](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule)

## 汇总

PhonePC/2in1TabletTVWearable

### 结构体

PhonePC/2in1TabletTVWearable

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| [ArkUI\_NativeGestureAPI\_1](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-nativegestureapi-1) | ArkUI\_NativeGestureAPI\_1 | 手势模块接口集合。 |
| [ArkUI\_NativeGestureAPI\_2](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-nativegestureapi-2) | - | 定义手势模块接口集合。 |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer) | ArkUI\_GestureRecognizer | 提供手势组件实例对象定义。 |
| [ArkUI\_GestureInterruptInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureinterruptinfo) | ArkUI\_GestureInterruptInfo | 提供手势打断数据类型对象定义。 |
| [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent) | ArkUI\_GestureEvent | 提供手势事件数据类型对象定义。 |
| [ArkUI\_GestureEventTargetInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/pi-arkui-nativemodule-arkui-gestureeventtargetinfo) | ArkUI\_GestureEventTargetInfo | 提供手势事件目标信息类型对象定义。 |
| [ArkUI\_ParallelInnerGestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkui-nativemodule-arkui-parallelinnergestureevent) | ArkUI\_ParallelInnerGestureEvent | 提供并行内置手势事件类型对象定义。 |
| [ArkUI\_TouchRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-touchrecognizer) | ArkUI\_TouchRecognizer | 定义触摸识别器。 |
| [ArkUI\_TouchRecognizer\*](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/api-arkui-nativemodule-arkui-touchrecognizerhandle) | ArkUI\_TouchRecognizerHandle | 定义触摸识别器句柄。 |
| [ArkUI\_TouchRecognizerHandle\*](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/rkui-nativemodule-arkui-touchrecognizerhandlearray) | ArkUI\_TouchRecognizerHandleArray | 定义触摸识别器句柄数组。 |
| [ArkUI\_GestureRecognizer\*](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/i-arkui-nativemodule-arkui-gesturerecognizerhandle) | ArkUI\_GestureRecognizerHandle | 提供手势识别器句柄类型对象定义。 |
| [ArkUI\_GestureRecognizerHandle\*](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ui-nativemodule-arkui-gesturerecognizerhandlearray) | ArkUI\_GestureRecognizerHandleArray | 提供手势识别器句柄类型数组对象定义。 |

### 枚举

PhonePC/2in1TabletTVWearable

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| [ArkUI\_GestureEventActionType](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gestureeventactiontype) | ArkUI\_GestureEventActionType | 定义手势事件类型。 |
| [ArkUI\_GesturePriority](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gesturepriority) | ArkUI\_GesturePriority | 定义手势事件模式。 |
| [ArkUI\_GroupGestureMode](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_groupgesturemode) | ArkUI\_GroupGestureMode | 定义手势组事件模式。 |
| [ArkUI\_GestureDirection](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gesturedirection) | ArkUI\_GestureDirection | 定义滑动手势方向。 |
| [ArkUI\_GestureMask](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gesturemask) | ArkUI\_GestureMask | 定义手势屏蔽模式。 |
| [ArkUI\_GestureRecognizerType](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gesturerecognizertype) | ArkUI\_GestureRecognizerType | 定义手势类型。 |
| [ArkUI\_GestureInterruptResult](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gestureinterruptresult) | ArkUI\_GestureInterruptResult | 定义手势打断结果。 |
| [ArkUI\_GestureRecognizerState](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gesturerecognizerstate) | ArkUI\_GestureRecognizerState | 定义手势识别器状态。 |

### 函数

PhonePC/2in1TabletTVWearable

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| [typedef void (\*ArkUI\_GestureRecognizerDisposeNotifyCallback)(ArkUI\_GestureRecognizer\* recognizer, void\* userData)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gesturerecognizerdisposenotifycallback) | ArkUI\_GestureRecognizerDisposeNotifyCallback | 定义手势识别器析构通知事件的回调函数类型。 |
| [bool OH\_ArkUI\_GestureInterruptInfo\_GetSystemFlag(const ArkUI\_GestureInterruptInfo\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureinterruptinfo_getsystemflag) | - | 判断是否为系统内置手势。 |
| [ArkUI\_GestureRecognizer\* OH\_ArkUI\_GestureInterruptInfo\_GetRecognizer(const ArkUI\_GestureInterruptInfo\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureinterruptinfo_getrecognizer) | - | 返回被打断的手势指针。 |
| [ArkUI\_GestureEvent\* OH\_ArkUI\_GestureInterruptInfo\_GetGestureEvent(const ArkUI\_GestureInterruptInfo\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureinterruptinfo_getgestureevent) | - | 返回打断的手势事件数据。 |
| [int32\_t OH\_ArkUI\_GestureInterruptInfo\_GetSystemRecognizerType(const ArkUI\_GestureInterruptInfo\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureinterruptinfo_getsystemrecognizertype) | - | 当要触发的是系统内置手势时，使用该方法可返回该系统内置手势的类型。 |
| [int32\_t OH\_ArkUI\_GestureInterruptInfo\_GetTouchRecognizers(const ArkUI\_GestureInterruptInfo\* info,ArkUI\_TouchRecognizerHandleArray\* recognizers, int32\_t\* size)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureinterruptinfo_gettouchrecognizers) | - | 从手势打断信息中获取触摸识别器。 |
| [ArkUI\_NodeHandle OH\_ArkUI\_TouchRecognizer\_GetNodeHandle(const ArkUI\_TouchRecognizerHandle recognizer)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_touchrecognizer_getnodehandle) | - | 获取触摸识别器对应的组件句柄。 |
| [int32\_t OH\_ArkUI\_TouchRecognizer\_CancelTouch(ArkUI\_TouchRecognizerHandle recognizer, ArkUI\_GestureInterruptInfo\* info)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_touchrecognizer_canceltouch) | - | 在手势打断回调中向指定的触摸识别器发送取消触摸的事件 |
| [ArkUI\_GestureEventActionType OH\_ArkUI\_GestureEvent\_GetActionType(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureevent_getactiontype) | - | 返回手势事件类型。 |
| [const ArkUI\_UIInputEvent\* OH\_ArkUI\_GestureEvent\_GetRawInputEvent(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureevent_getrawinputevent) | - | 返回手势输入。 |
| [int32\_t OH\_ArkUI\_LongPress\_GetRepeatCount(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_longpress_getrepeatcount) | - | 返回是否为重复触发事件。 |
| [float OH\_ArkUI\_PanGesture\_GetVelocity(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pangesture_getvelocity) | - | 滑动手势返回手势主方向速度。 |
| [float OH\_ArkUI\_PanGesture\_GetVelocityX(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pangesture_getvelocityx) | - | 滑动手势返回当前手势的x轴方向速度。 |
| [float OH\_ArkUI\_PanGesture\_GetVelocityY(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pangesture_getvelocityy) | - | 滑动手势返回当前手势的y轴方向速度。 |
| [float OH\_ArkUI\_PanGesture\_GetOffsetX(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pangesture_getoffsetx) | - | 滑动手势返回当前手势事件x轴相对偏移量。 |
| [float OH\_ArkUI\_PanGesture\_GetOffsetY(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pangesture_getoffsety) | - | 滑动手势返回当前手势事件y轴相对偏移量。 |
| [float OH\_ArkUI\_SwipeGesture\_GetAngle(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_swipegesture_getangle) | - | 快滑手势返回当前手势事件角度信息。角度计算方式：快滑手势被识别到后，连接两根手指之间的线被识别为起始线条，随着手指的滑动，手指之间的线条会发生旋转，  根据起始线条两端点和当前线条两端点的坐标，使用反正切函数分别计算其相对于水平方向的夹角，  最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。  以起始线条为坐标系，顺时针旋转为0到180度，逆时针旋转为-180到0度。 |
| [float OH\_ArkUI\_SwipeGesture\_GetVelocity(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_swipegesture_getvelocity) | - | 快滑手势场景中所有手指滑动平均速度。 |
| [float OH\_ArkUI\_RotationGesture\_GetAngle(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_rotationgesture_getangle) | - | 旋转手势返回当前手势事件角度信息。 |
| [float OH\_ArkUI\_PinchGesture\_GetScale(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pinchgesture_getscale) | - | 捏合手势返回当前手势事件缩放信息。 |
| [float OH\_ArkUI\_PinchGesture\_GetCenterX(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pinchgesture_getcenterx) | - | 捏合手势中心点相对于当前组件元素左上角x轴坐标。 |
| [float OH\_ArkUI\_PinchGesture\_GetCenterY(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pinchgesture_getcentery) | - | 捏合手势中心点相对于当前组件元素左上角y轴坐标。 |
| [ArkUI\_NodeHandle OH\_ArkUI\_GestureEvent\_GetNode(const ArkUI\_GestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureevent_getnode) | - | 获取绑定该手势的ARKUI组件 |
| [int32\_t OH\_ArkUI\_GetResponseRecognizersFromInterruptInfo(const ArkUI\_GestureInterruptInfo\* event,ArkUI\_GestureRecognizerHandleArray\* responseChain, int32\_t\* count)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getresponserecognizersfrominterruptinfo) | - | 获取手势响应链的信息。 |
| [int32\_t OH\_ArkUI\_SetGestureRecognizerEnabled(ArkUI\_GestureRecognizer\* recognizer, bool enabled)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_setgesturerecognizerenabled) | - | 设置手势识别器的使能状态。 |
| [int32\_t OH\_ArkUI\_SetGestureRecognizerLimitFingerCount(ArkUI\_GestureRecognizer\* recognizer, bool limitFingerCount)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_setgesturerecognizerlimitfingercount) | - | 设置是否严格检查触摸手指数量的标志。实际触摸手指数量不等于设置的手指数量的时候，该手势识别不成功。 |
| [bool OH\_ArkUI\_GetGestureRecognizerEnabled(ArkUI\_GestureRecognizer\* recognizer)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgesturerecognizerenabled) | - | 获取手势识别器的使能状态。 |
| [int32\_t OH\_ArkUI\_GetGestureRecognizerState(ArkUI\_GestureRecognizer\* recognizer, ArkUI\_GestureRecognizerState\* state)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgesturerecognizerstate) | - | 获取手势识别器的状态。 |
| [int32\_t OH\_ArkUI\_GetGestureEventTargetInfo(ArkUI\_GestureRecognizer\* recognizer, ArkUI\_GestureEventTargetInfo\*\* info)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureeventtargetinfo) | - | 获取手势事件目标信息。 |
| [int32\_t OH\_ArkUI\_GestureEventTargetInfo\_IsScrollBegin(ArkUI\_GestureEventTargetInfo\* info, bool\* ret)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureeventtargetinfo_isscrollbegin) | - | 当前滚动类容器组件是否在顶部。 |
| [int32\_t OH\_ArkUI\_GestureEventTargetInfo\_IsScrollEnd(ArkUI\_GestureEventTargetInfo\* info, bool\* ret)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureeventtargetinfo_isscrollend) | - | 当前滚动类容器组件是否在底部。 |
| [int32\_t OH\_ArkUI\_GetPanGestureDirectionMask(ArkUI\_GestureRecognizer\* recognizer,ArkUI\_GestureDirectionMask\* directionMask)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getpangesturedirectionmask) | - | 获取滑动手势的滑动方向。 |
| [bool OH\_ArkUI\_IsBuiltInGesture(ArkUI\_GestureRecognizer\* recognizer)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_isbuiltingesture) | - | 当前手势是否为系统内置手势。 |
| [int32\_t OH\_ArkUI\_GetGestureTag(ArkUI\_GestureRecognizer\* recognizer, char\* buffer, int32\_t bufferSize, int32\_t\* result)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgesturetag) | - | 获取手势识别器的标记。 |
| [int32\_t OH\_ArkUI\_GetGestureBindNodeId(ArkUI\_GestureRecognizer\* recognizer, char\* nodeId, int32\_t size,int32\_t\* result)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgesturebindnodeid) | - | 获取手势识别器绑定的组件的ID。 |
| [bool OH\_ArkUI\_IsGestureRecognizerValid(ArkUI\_GestureRecognizer\* recognizer)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_isgesturerecognizervalid) | - | 当前手势识别器是否有效。 |
| [void\* OH\_ArkUI\_ParallelInnerGestureEvent\_GetUserData(ArkUI\_ParallelInnerGestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_parallelinnergestureevent_getuserdata) | - | 获取并行内置手势事件中的用户自定义数据。 |
| [ArkUI\_GestureRecognizer\* OH\_ArkUI\_ParallelInnerGestureEvent\_GetCurrentRecognizer(ArkUI\_ParallelInnerGestureEvent\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_parallelinnergestureevent_getcurrentrecognizer) | - | 获取并行内置手势事件中的当前手势识别器。 |
| [int32\_t OH\_ArkUI\_ParallelInnerGestureEvent\_GetConflictRecognizers(ArkUI\_ParallelInnerGestureEvent\* event,ArkUI\_GestureRecognizerHandleArray\* array, int32\_t\* size)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_parallelinnergestureevent_getconflictrecognizers) | - | 获取并行内置手势事件中的冲突的手势识别器。 |
| [int32\_t OH\_ArkUI\_SetArkUIGestureRecognizerDisposeNotify(ArkUI\_GestureRecognizer\* recognizer,ArkUI\_GestureRecognizerDisposeNotifyCallback callback, void\* userData)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_setarkuigesturerecognizerdisposenotify) | - | 设置手势识别器对象析构通知回调函数。 |
| [int32\_t OH\_ArkUI\_GetGestureParam\_DirectMask(ArkUI\_GestureRecognizer\* recognizer, ArkUI\_GestureDirectionMask\* directMask)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureparam_directmask) | - | 获取手势识别器的滑动方向。 |
| [int32\_t OH\_ArkUI\_GetGestureParam\_FingerCount(ArkUI\_GestureRecognizer\* recognizer, int\* finger)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureparam_fingercount) | - | 获取手势识别器的手指数。 |
| [int32\_t OH\_ArkUI\_GetGestureParam\_limitFingerCount(ArkUI\_GestureRecognizer\* recognizer, bool\* isLimited)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureparam_limitfingercount) | - | 获取手势识别器是否有手指数限制。 |
| [int32\_t OH\_ArkUI\_GetGestureParam\_repeat(ArkUI\_GestureRecognizer\* recognizer, bool\* isRepeat)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureparam_repeat) | - | 获取手势识别器是否连续触发事件回调。 |
| [int32\_t OH\_ArkUI\_GetGestureParam\_distance(ArkUI\_GestureRecognizer\* recognizer, double\* distance)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureparam_distance) | - | 获取手势识别器的手指允许的移动距离范围。 |
| [int32\_t OH\_ArkUI\_GetGestureParam\_speed(ArkUI\_GestureRecognizer\* recognizer, double\* speed)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureparam_speed) | - | 获取手势识别器的识别滑动的最小速度。 |
| [int32\_t OH\_ArkUI\_GetGestureParam\_duration(ArkUI\_GestureRecognizer\* recognizer, int\* duration)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureparam_duration) | - | 获取手势识别器的触发长按的最短时间。 |
| [int32\_t OH\_ArkUI\_GetGestureParam\_angle(ArkUI\_GestureRecognizer\* recognizer, double\* angle)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureparam_angle) | - | 获取手势识别器的旋转手势的最小改变度数。 |
| [int32\_t OH\_ArkUI\_GetGestureParam\_distanceThreshold(ArkUI\_GestureRecognizer\* recognizer, double\* distanceThreshold)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_getgestureparam_distancethreshold) | - | 获取手势识别器的手势移动阈值。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_PanGesture\_SetDistanceMap(ArkUI\_GestureRecognizer\* recognizer, int size, int\* toolTypeArray, double\* distanceArray)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pangesture_setdistancemap) | - | 设置手势最小滑动阈值表。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_PanGesture\_GetDistanceByToolType(ArkUI\_GestureRecognizer\* recognizer, int toolType, double\* distance)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_pangesture_getdistancebytooltype) | - | 获取手势识别器的手势移动阈值表。仅支持对通过OH\_ArkUI\_PanGesture\_SetDistanceMap修改过的设备类型的阈值查询。默认滑动阈值可通过查询UI\_INPUT\_EVENT\_TOOL\_TYPE\_UNKNOWN类型获得，其他未设置过的类型不会返回。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_SetTouchTestDoneCallback(ArkUI\_NodeHandle node,void\* userData,void (\*touchTestDone)(ArkUI\_GestureEvent\* event,ArkUI\_GestureRecognizerHandleArray recognizers,int32\_t count,void\* userData))](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_settouchtestdonecallback) | - | 注册一个在所有手势识别器收集完成后执行的回调函数。当用户开始触摸屏幕时，系统会进行命中测试并根据触摸位置收集手势识别器。随后，在处理任何移动事件之前，组件可以使用此接口确定将参与识别并相互竞争的手势识别器。 |
| [void\* OH\_ArkUI\_GestureInterrupter\_GetUserData(ArkUI\_GestureInterruptInfo\* event)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_gestureinterrupter_getuserdata) | - | 获取手势中断事件中的用户自定义数据。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_PreventGestureRecognizerBegin(ArkUI\_GestureRecognizer\* recognizer)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_preventgesturerecognizerbegin) | - | 在手指全部抬起前阻止手势识别器参与当前手势识别。如果系统已确定该手势识别器的结果（无论成功与否），调用此接口将无效。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_LongPressGesture\_SetAllowableMovement(ArkUI\_GestureRecognizer\* recognizer, double allowableMovement)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_longpressgesture_setallowablemovement) | - | 设置长按手势识别器识别的手势的最大移动距离。 |
| [ArkUI\_ErrorCode OH\_ArkUI\_LongPressGesture\_GetAllowableMovement(ArkUI\_GestureRecognizer\* recognizer, double\* allowableMovement)](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#oh_arkui_longpressgesture_getallowablemovement) | - | 获取长按手势识别器识别的手势的最大移动距离。 |

### 变量

PhonePC/2in1TabletTVWearable

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| uint32\_t | ArkUI\_GestureDirectionMask | 定义滑动手势方向集合。  例：ArkUI\_GestureDirectionMask directions = GESTURE\_DIRECTION\_LEFT | GESTURE\_DIRECTION\_RIGHT。  directions 表明支持左右水平方向。 |
| uint32\_t | ArkUI\_GestureEventActionTypeMask | 定义手势事件类型集合。例：ArkUI\_GestureEventActionTypeMask actions = GESTURE\_EVENT\_ACTION\_ACCEPT | GESTURE\_EVENT\_ACTION\_UPDATE。 |

### 示例

PhonePC/2in1TabletTVWearable

展开

| 名称 | 描述 |
| --- | --- |
| [NdkGestureSetting](https://gitcode.com/HarmonyOS_Samples/guide-snippets/tree/master/ArkUISample/NdkGestureSetting) | 从API version 20开始，新增手势绑定、手势移除以及自定义手势判断的示例。 |
| [NdkGestureNestScroll](https://gitcode.com/HarmonyOS_Samples/guide-snippets/tree/master/ArkUISample/NdkGestureNestScroll) | 从API version 20开始，新增手势接口实现嵌套滚动的示例。 |
| [NdkGestureBlocking](https://gitcode.com/HarmonyOS_Samples/guide-snippets/tree/master/ArkUISample/NdkGestureBlocking) | 从API version 20开始，新增手势拦截的示例。 |

## 枚举类型说明

PhonePC/2in1TabletTVWearable

### ArkUI\_GestureEventActionType

PhonePC/2in1TabletTVWearable



```
1. enum ArkUI_GestureEventActionType
```

**描述：**

定义手势事件类型。

**起始版本：** 12

展开

| 枚举项 | 描述 |
| --- | --- |
| GESTURE\_EVENT\_ACTION\_ACCEPT = 0x01 | 手势事件触发。 |
| GESTURE\_EVENT\_ACTION\_UPDATE = 0x02 | 手势事件更新。 |
| GESTURE\_EVENT\_ACTION\_END = 0x04 | 手势事件结束。 |
| GESTURE\_EVENT\_ACTION\_CANCEL = 0x08 | 手势事件取消。 |

### ArkUI\_GesturePriority

PhonePC/2in1TabletTVWearable



```
1. enum ArkUI_GesturePriority
```

**描述：**

定义手势事件模式。

**起始版本：** 12

展开

| 枚举项 | 描述 |
| --- | --- |
| NORMAL = 0 | 正常手势。 |
| PRIORITY = 1 | 高优先级手势。 |
| PARALLEL = 2 | 并发手势。 |

### ArkUI\_GroupGestureMode

PhonePC/2in1TabletTVWearable



```
1. enum ArkUI_GroupGestureMode
```

**描述：**

定义手势组事件模式。

**起始版本：** 12

展开

| 枚举项 | 描述 |
| --- | --- |
| SEQUENTIAL\_GROUP = 0 | 顺序手势模式，按照注册顺序识别手势，直到所有手势识别成功。若有识别失败，后续识别均失败。仅有最后一个手势响应结束事件。 |
| PARALLEL\_GROUP = 1 | 并发手势模式，注册的手势同时识别，直到所有手势识别结束，手势识别互相不影响。 |
| EXCLUSIVE\_GROUP = 2 | 互斥手势模式，注册的手势同时识别，若有一个手势识别成功，则结束手势识别。 |

### ArkUI\_GestureDirection

PhonePC/2in1TabletTVWearable



```
1. enum ArkUI_GestureDirection
```

**描述：**

定义滑动手势方向。

**起始版本：** 12

展开

| 枚举项 | 描述 |
| --- | --- |
| GESTURE\_DIRECTION\_ALL = 0b1111 | 所有方向。 |
| GESTURE\_DIRECTION\_HORIZONTAL = 0b0011 | 水平方向。 |
| GESTURE\_DIRECTION\_VERTICAL = 0b1100 | 竖直方向。 |
| GESTURE\_DIRECTION\_LEFT = 0b0001 | 向左方向。 |
| GESTURE\_DIRECTION\_RIGHT = 0b0010 | 向右方向。 |
| GESTURE\_DIRECTION\_UP = 0b0100 | 向上方向。 |
| GESTURE\_DIRECTION\_DOWN = 0b1000 | 向下方向。 |
| GESTURE\_DIRECTION\_NONE = 0 | 任何方向都不触发手势事件。 |

### ArkUI\_GestureMask

PhonePC/2in1TabletTVWearable



```
1. enum ArkUI_GestureMask
```

**描述：**

定义手势屏蔽模式。

**起始版本：** 12

展开

| 枚举项 | 描述 |
| --- | --- |
| NORMAL\_GESTURE\_MASK = 0 | 不屏蔽子组件的手势，按照默认手势识别顺序进行识别。 |
| IGNORE\_INTERNAL\_GESTURE\_MASK = 1 | 屏蔽子组件的手势，包括子组件上系统内置的手势。 |

### ArkUI\_GestureRecognizerType

PhonePC/2in1TabletTVWearable



```
1. enum ArkUI_GestureRecognizerType
```

**描述：**

定义手势类型。

**起始版本：** 12

展开

| 枚举项 | 描述 |
| --- | --- |
| TAP\_GESTURE = 0 | 敲击手势。 |
| LONG\_PRESS\_GESTURE = 1 | 长按手势。 |
| PAN\_GESTURE = 2 | 滑动手势。 |
| PINCH\_GESTURE = 3 | 捏合手势。 |
| ROTATION\_GESTURE = 4 | 旋转手势。 |
| SWIPE\_GESTURE = 5 | 快滑手势。 |
| GROUP\_GESTURE = 6 | 手势组合。 |
| CLICK\_GESTURE = 7 | 通过onClick注册的点击手势。  **起始版本：** 20 |
| DRAG\_DROP = 8 | 用于拖放的拖拽手势。  **起始版本：** 20 |

### ArkUI\_GestureInterruptResult

PhonePC/2in1TabletTVWearable



```
1. enum ArkUI_GestureInterruptResult
```

**描述：**

定义手势打断结果。

**起始版本：** 12

展开

| 枚举项 | 描述 |
| --- | --- |
| GESTURE\_INTERRUPT\_RESULT\_CONTINUE = 0 | 手势继续。 |
| GESTURE\_INTERRUPT\_RESULT\_REJECT = 1 | 手势打断。 |

### ArkUI\_GestureRecognizerState

PhonePC/2in1TabletTVWearable



```
1. enum ArkUI_GestureRecognizerState
```

**描述：**

定义手势识别器状态。

**起始版本：** 12

展开

| 枚举项 | 描述 |
| --- | --- |
| ARKUI\_GESTURE\_RECOGNIZER\_STATE\_READY = 0 | 准备状态。 |
| ARKUI\_GESTURE\_RECOGNIZER\_STATE\_DETECTING = 1 | 检测状态。 |
| ARKUI\_GESTURE\_RECOGNIZER\_STATE\_PENDING = 2 | 等待状态。 |
| ARKUI\_GESTURE\_RECOGNIZER\_STATE\_BLOCKED = 3 | 阻塞状态。 |
| ARKUI\_GESTURE\_RECOGNIZER\_STATE\_SUCCESSFUL = 4 | 成功状态。 |
| ARKUI\_GESTURE\_RECOGNIZER\_STATE\_FAILED = 5 | 失败状态。 |

## 函数说明

PhonePC/2in1TabletTVWearable

### ArkUI\_GestureRecognizerDisposeNotifyCallback()

PhonePC/2in1TabletTVWearable



```
1. typedef void (*ArkUI_GestureRecognizerDisposeNotifyCallback)(ArkUI_GestureRecognizer* recognizer, void* userData)
```

**描述：**

定义手势识别器析构通知事件的回调函数类型。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| void\* userData | 用户自定义数据。 |

### OH\_ArkUI\_GestureInterruptInfo\_GetSystemFlag()

PhonePC/2in1TabletTVWearable



```
1. bool OH_ArkUI_GestureInterruptInfo_GetSystemFlag(const ArkUI_GestureInterruptInfo* event)
```

**描述：**

判断是否为系统内置手势。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureInterruptInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureinterruptinfo)\* event | 手势打断回调事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| bool | true: 系统内置手势；  false: 非系统内置手势。 |

### OH\_ArkUI\_GestureInterruptInfo\_GetRecognizer()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_GestureRecognizer* OH_ArkUI_GestureInterruptInfo_GetRecognizer(const ArkUI_GestureInterruptInfo* event)
```

**描述：**

返回被打断的手势指针。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureInterruptInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureinterruptinfo)\* event | 手势打断回调事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* | 被打断的手势指针。 |

### OH\_ArkUI\_GestureInterruptInfo\_GetGestureEvent()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_GestureEvent* OH_ArkUI_GestureInterruptInfo_GetGestureEvent(const ArkUI_GestureInterruptInfo* event)
```

**描述：**

返回打断的手势事件数据。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureInterruptInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureinterruptinfo)\* event | 手势打断回调事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* | 打断的手势事件数据。 |

### OH\_ArkUI\_GestureInterruptInfo\_GetSystemRecognizerType()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType(const ArkUI_GestureInterruptInfo* event)
```

**描述：**

当要触发的是系统内置手势时，使用该方法可返回该系统内置手势的类型。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureInterruptInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureinterruptinfo)\* event | 手势打断回调事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 要触发的系统内置手势对应的手势类型，取值由[ArkUI\_GestureRecognizerType](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gesturerecognizertype)定义。如果当前触发的手势不是系统内置手势，则返回-1。 |

### OH\_ArkUI\_GestureInterruptInfo\_GetTouchRecognizers()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GestureInterruptInfo_GetTouchRecognizers(const ArkUI_GestureInterruptInfo* info,ArkUI_TouchRecognizerHandleArray* recognizers, int32_t* size)
```

**描述：**

从手势打断信息中获取触摸识别器。

**起始版本：** 15

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureInterruptInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureinterruptinfo)\* info | 指向手势打断信息的指针。 |
| [ArkUI\_TouchRecognizerHandleArray](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/rkui-nativemodule-arkui-touchrecognizerhandlearray)\* recognizers | 指向触摸识别器数组的指针。 |
| int32\_t\* size | 触摸识别器数组的大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  返回 [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 表示成功。  返回 [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 表示参数错误。 |

### OH\_ArkUI\_TouchRecognizer\_GetNodeHandle()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_NodeHandle OH_ArkUI_TouchRecognizer_GetNodeHandle(const ArkUI_TouchRecognizerHandle recognizer)
```

**描述：**

获取触摸识别器对应的组件句柄。

**起始版本：** 15

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_TouchRecognizerHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/rkui-nativemodule-arkui-touchrecognizerhandlearray) recognizer | 触摸识别器的句柄。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) | 触摸识别器对应的组件句柄。 |

### OH\_ArkUI\_TouchRecognizer\_CancelTouch()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_TouchRecognizer_CancelTouch(ArkUI_TouchRecognizerHandle recognizer, ArkUI_GestureInterruptInfo* info)
```

**描述：**

在手势打断回调中向指定的触摸识别器发送取消触摸的事件

**起始版本：** 15

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_TouchRecognizerHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/rkui-nativemodule-arkui-touchrecognizerhandlearray) recognizer | 触摸识别器的句柄。 |
| [ArkUI\_GestureInterruptInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureinterruptinfo)\* info | 指向手势打断信息的指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  返回 [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  返回 [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。 |

### OH\_ArkUI\_GestureEvent\_GetActionType()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_GestureEventActionType OH_ArkUI_GestureEvent_GetActionType(const ArkUI_GestureEvent* event)
```

**描述：**

返回手势事件类型。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_GestureEventActionType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gestureeventactiontype) | 手势事件类型。 |

### OH\_ArkUI\_GestureEvent\_GetRawInputEvent()

PhonePC/2in1TabletTVWearable



```
1. const ArkUI_UIInputEvent* OH_ArkUI_GestureEvent_GetRawInputEvent(const ArkUI_GestureEvent* event)
```

**描述：**

返回手势输入。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| const [ArkUI\_UIInputEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-eventmodule-arkui-uiinputevent)\* | 手势事件的原始输入事件。 |

### OH\_ArkUI\_LongPress\_GetRepeatCount()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_LongPress_GetRepeatCount(const ArkUI_GestureEvent* event)
```

**描述：**

返回是否为重复触发事件。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 是否为重复触发事件。1表示为重复触发事件，0表示为非重复触发事件。 |

### OH\_ArkUI\_PanGesture\_GetVelocity()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_PanGesture_GetVelocity(const ArkUI_GestureEvent* event)
```

**描述：**

滑动手势返回手势主方向速度。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 当前手势主方向速度，为xy轴方向速度的平方和的算数平方根，单位px/秒。 |

### OH\_ArkUI\_PanGesture\_GetVelocityX()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_PanGesture_GetVelocityX(const ArkUI_GestureEvent* event)
```

**描述：**

滑动手势返回当前手势的x轴方向速度。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 当前手势的x轴方向速度，单位px/秒。 |

### OH\_ArkUI\_PanGesture\_GetVelocityY()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_PanGesture_GetVelocityY(const ArkUI_GestureEvent* event)
```

**描述：**

滑动手势返回当前手势的y轴方向速度。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 当前手势的y轴方向速度，单位px/秒。 |

### OH\_ArkUI\_PanGesture\_GetOffsetX()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_PanGesture_GetOffsetX(const ArkUI_GestureEvent* event)
```

**描述：**

滑动手势返回当前手势事件x轴相对偏移量。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 当前手势事件x轴相对偏移量，单位为px。 |

### OH\_ArkUI\_PanGesture\_GetOffsetY()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_PanGesture_GetOffsetY(const ArkUI_GestureEvent* event)
```

**描述：**

滑动手势返回当前手势事件y轴相对偏移量。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 当前手势事件y轴相对偏移量，单位为px。 |

### OH\_ArkUI\_SwipeGesture\_GetAngle()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_SwipeGesture_GetAngle(const ArkUI_GestureEvent* event)
```

**描述：**

快滑手势返回当前手势事件角度信息。角度计算方式：快滑手势被识别到后，连接两根手指之间的线被识别为起始线条，随着手指的滑动，手指之间的线条会发生旋转，

根据起始线条两端点和当前线条两端点的坐标，使用反正切函数分别计算其相对于水平方向的夹角，

最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。

以起始线条为坐标系，顺时针旋转为0到180度，逆时针旋转为-180到0度。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 快滑手势的角度，即两根手指间的线段与水平方向的夹角变化的度数。单位为deg。 |

### OH\_ArkUI\_SwipeGesture\_GetVelocity()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_SwipeGesture_GetVelocity(const ArkUI_GestureEvent* event)
```

**描述：**

快滑手势场景中所有手指滑动平均速度。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 快滑手势速度，即所有手指滑动的平均速度，单位为px/秒。 |

### OH\_ArkUI\_RotationGesture\_GetAngle()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_RotationGesture_GetAngle(const ArkUI_GestureEvent* event)
```

**描述：**

旋转手势返回当前手势事件角度信息。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 旋转角度。单位为deg。 |

### OH\_ArkUI\_PinchGesture\_GetScale()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_PinchGesture_GetScale(const ArkUI_GestureEvent* event)
```

**描述：**

捏合手势返回当前手势事件缩放信息。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 缩放比例。 |

### OH\_ArkUI\_PinchGesture\_GetCenterX()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_PinchGesture_GetCenterX(const ArkUI_GestureEvent* event)
```

**描述：**

捏合手势中心点相对于当前组件元素左上角x轴坐标。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 捏合手势中心点相对于当前组件元素左上角x轴坐标，单位为px。 |

### OH\_ArkUI\_PinchGesture\_GetCenterY()

PhonePC/2in1TabletTVWearable



```
1. float OH_ArkUI_PinchGesture_GetCenterY(const ArkUI_GestureEvent* event)
```

**描述：**

捏合手势中心点相对于当前组件元素左上角y轴坐标。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| float | 捏合手势中心点相对于当前组件元素左上角y轴坐标，单位为px。 |

### OH\_ArkUI\_GestureEvent\_GetNode()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetNode(const ArkUI_GestureEvent* event)
```

**描述：**

获取绑定该手势的ARKUI组件

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event | 手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) | 绑定该手势的ARKUI组件。若返回Null，则表示event是无效值。 |

### OH\_ArkUI\_GetResponseRecognizersFromInterruptInfo()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetResponseRecognizersFromInterruptInfo(const ArkUI_GestureInterruptInfo* event,ArkUI_GestureRecognizerHandleArray* responseChain, int32_t* count)
```

**描述：**

获取手势响应链的信息。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| const [ArkUI\_GestureInterruptInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureinterruptinfo)\* event | 手势打断回调事件。 |
| [ArkUI\_GestureRecognizerHandleArray](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ui-nativemodule-arkui-gesturerecognizerhandlearray)\* responseChain | 响应链组件上的手势识别器。 |
| int32\_t\* count | 响应链组件上的手势识别器的数量。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。 |

### OH\_ArkUI\_SetGestureRecognizerEnabled()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_SetGestureRecognizerEnabled(ArkUI_GestureRecognizer* recognizer, bool enabled)
```

**描述：**

设置手势识别器的使能状态。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| bool enabled | 使能状态。true表示使能，false表示无法使能。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。 |

### OH\_ArkUI\_SetGestureRecognizerLimitFingerCount()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_SetGestureRecognizerLimitFingerCount(ArkUI_GestureRecognizer* recognizer, bool limitFingerCount)
```

**描述：**

设置是否严格检查触摸手指数量的标志。实际触摸手指数量不等于设置的手指数量的时候，该手势识别不成功。

**起始版本：** 15

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| bool limitFingerCount | 表示严格检查触摸手指数量的状态。true表示检查手指数量，false表示不检查手指数量。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。 |

### OH\_ArkUI\_GetGestureRecognizerEnabled()

PhonePC/2in1TabletTVWearable



```
1. bool OH_ArkUI_GetGestureRecognizerEnabled(ArkUI_GestureRecognizer* recognizer)
```

**描述：**

获取手势识别器的使能状态。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| bool | true - 使能。  false - 禁用。 |

### OH\_ArkUI\_GetGestureRecognizerState()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureRecognizerState(ArkUI_GestureRecognizer* recognizer, ArkUI_GestureRecognizerState* state)
```

**描述：**

获取手势识别器的状态。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| [ArkUI\_GestureRecognizerState](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gesturerecognizerstate)\* state | 手势识别器的状态。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。 |

### OH\_ArkUI\_GetGestureEventTargetInfo()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureEventTargetInfo(ArkUI_GestureRecognizer* recognizer, ArkUI_GestureEventTargetInfo** info)
```

**描述：**

获取手势事件目标信息。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| [ArkUI\_GestureEventTargetInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/pi-arkui-nativemodule-arkui-gestureeventtargetinfo)\*\* info | 手势事件目标信息。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。 |

### OH\_ArkUI\_GestureEventTargetInfo\_IsScrollBegin()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollBegin(ArkUI_GestureEventTargetInfo* info, bool* ret)
```

**描述：**

当前滚动类容器组件是否在顶部。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureEventTargetInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/pi-arkui-nativemodule-arkui-gestureeventtargetinfo)\* info | 手势事件目标信息。 |
| bool\* ret | 当前滚动类容器组件是否在顶部。true表示在顶部，false表示不在顶部。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。  [ARKUI\_ERROR\_CODE\_NON\_SCROLLABLE\_CONTAINER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 非滚动类容器。 |

### OH\_ArkUI\_GestureEventTargetInfo\_IsScrollEnd()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollEnd(ArkUI_GestureEventTargetInfo* info, bool* ret)
```

**描述：**

当前滚动类容器组件是否在底部。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureEventTargetInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/pi-arkui-nativemodule-arkui-gestureeventtargetinfo)\* info | 手势事件目标信息。 |
| bool\* ret | 当前滚动类容器组件是否在底部。true表示在底部，false表示不在底部。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。  [ARKUI\_ERROR\_CODE\_NON\_SCROLLABLE\_CONTAINER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 非滚动类容器。 |

### OH\_ArkUI\_GetPanGestureDirectionMask()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetPanGestureDirectionMask(ArkUI_GestureRecognizer* recognizer,ArkUI_GestureDirectionMask* directionMask)
```

**描述：**

获取滑动手势的滑动方向。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| [ArkUI\_GestureDirectionMask](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#变量)\* directionMask | 滑动手势的滑动方向。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。 |

### OH\_ArkUI\_IsBuiltInGesture()

PhonePC/2in1TabletTVWearable



```
1. bool OH_ArkUI_IsBuiltInGesture(ArkUI_GestureRecognizer* recognizer)
```

**描述：**

当前手势是否为系统内置手势。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| bool | true - 是系统内置手势。  false - 不是系统内置手势。 |

### OH\_ArkUI\_GetGestureTag()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureTag(ArkUI_GestureRecognizer* recognizer, char* buffer, int32_t bufferSize, int32_t* result)
```

**描述：**

获取手势识别器的标记。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| char\* buffer | 存储区。 |
| int32\_t bufferSize | 存储区大小。 |
| int32\_t\* result | 拷贝的字符串长度。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。  [ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_NOT\_ENOUGH](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 存储区大小不足。 |

### OH\_ArkUI\_GetGestureBindNodeId()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureBindNodeId(ArkUI_GestureRecognizer* recognizer, char* nodeId, int32_t size,int32_t* result)
```

**描述：**

获取手势识别器绑定的组件的ID。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| char\* nodeId | 组件的ID。 |
| int32\_t size | 存储区大小。 |
| int32\_t\* result | 拷贝的字符串长度。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。  [ARKUI\_ERROR\_CODE\_BUFFER\_SIZE\_NOT\_ENOUGH](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 存储区大小不足。 |

### OH\_ArkUI\_IsGestureRecognizerValid()

PhonePC/2in1TabletTVWearable



```
1. bool OH_ArkUI_IsGestureRecognizerValid(ArkUI_GestureRecognizer* recognizer)
```

**描述：**

当前手势识别器是否有效。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| bool | true - 手势识别器有效。  false - 手势识别器无效。 |

### OH\_ArkUI\_ParallelInnerGestureEvent\_GetUserData()

PhonePC/2in1TabletTVWearable



```
1. void* OH_ArkUI_ParallelInnerGestureEvent_GetUserData(ArkUI_ParallelInnerGestureEvent* event)
```

**描述：**

获取并行内置手势事件中的用户自定义数据。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_ParallelInnerGestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkui-nativemodule-arkui-parallelinnergestureevent)\* event | 并行内置手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| void\* | 用户自定义数据的指针。 |

### OH\_ArkUI\_ParallelInnerGestureEvent\_GetCurrentRecognizer()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_GestureRecognizer* OH_ArkUI_ParallelInnerGestureEvent_GetCurrentRecognizer(ArkUI_ParallelInnerGestureEvent* event)
```

**描述：**

获取并行内置手势事件中的当前手势识别器。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_ParallelInnerGestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkui-nativemodule-arkui-parallelinnergestureevent)\* event | 并行内置手势事件。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* | 当前手势识别器的指针。 |

### OH\_ArkUI\_ParallelInnerGestureEvent\_GetConflictRecognizers()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_ParallelInnerGestureEvent_GetConflictRecognizers(ArkUI_ParallelInnerGestureEvent* event,ArkUI_GestureRecognizerHandleArray* array, int32_t* size)
```

**描述：**

获取并行内置手势事件中的冲突的手势识别器。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_ParallelInnerGestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkui-nativemodule-arkui-parallelinnergestureevent)\* event | 并行内置手势事件。 |
| [ArkUI\_GestureRecognizerHandleArray](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ui-nativemodule-arkui-gesturerecognizerhandlearray)\* array | 冲突的手势识别器数组。 |
| int32\_t\* size | 冲突的手势识别器数组的大小。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。 |

### OH\_ArkUI\_SetArkUIGestureRecognizerDisposeNotify()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_SetArkUIGestureRecognizerDisposeNotify(ArkUI_GestureRecognizer* recognizer,ArkUI_GestureRecognizerDisposeNotifyCallback callback, void* userData)
```

**描述：**

设置手势识别器对象析构通知回调函数。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| [ArkUI\_GestureRecognizerDisposeNotifyCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#arkui_gesturerecognizerdisposenotifycallback) callback | 手势识别器对象析构通知回调函数。 |
| void\* userData | 用户自定义数据。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) - 参数错误。 |

### OH\_ArkUI\_GetGestureParam\_DirectMask()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureParam_DirectMask(ArkUI_GestureRecognizer* recognizer, ArkUI_GestureDirectionMask* directMask)
```

**描述：**

获取手势识别器的滑动方向。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| [ArkUI\_GestureDirectionMask](/consumer/cn/doc/harmonyos-references/capi-native-gesture-h#变量)\* directMask | 手势识别器的滑动方向。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。 |

### OH\_ArkUI\_GetGestureParam\_FingerCount()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureParam_FingerCount(ArkUI_GestureRecognizer* recognizer, int* finger)
```

**描述：**

获取手势识别器的手指数。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| int\* finger | 手势识别器的手指数。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。 |

### OH\_ArkUI\_GetGestureParam\_limitFingerCount()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureParam_limitFingerCount(ArkUI_GestureRecognizer* recognizer, bool* isLimited)
```

**描述：**

获取手势识别器是否有手指数限制。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| bool\* isLimited | 手势识别器是否有手指数限制。true表示有手指数限制，false表示没有手指数限制。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。 |

### OH\_ArkUI\_GetGestureParam\_repeat()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureParam_repeat(ArkUI_GestureRecognizer* recognizer, bool* isRepeat)
```

**描述：**

获取手势识别器是否连续触发事件回调。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| bool\* isRepeat | 手势识别器是否连续触发事件回调。true表示连续触发，false表示不连续触发。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |

### OH\_ArkUI\_GetGestureParam\_distance()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureParam_distance(ArkUI_GestureRecognizer* recognizer, double* distance)
```

**描述：**

获取手势识别器的手指允许的移动距离范围。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| double\* distance | 手势识别器的手指允许的移动距离范围。单位为px。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |

### OH\_ArkUI\_GetGestureParam\_speed()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureParam_speed(ArkUI_GestureRecognizer* recognizer, double* speed)
```

**描述：**

获取手势识别器的识别滑动的最小速度。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| double\* speed | 手势识别器的识别滑动的最小速度。单位为px/s。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |

### OH\_ArkUI\_GetGestureParam\_duration()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureParam_duration(ArkUI_GestureRecognizer* recognizer, int* duration)
```

**描述：**

获取手势识别器的触发长按的最短时间。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| int\* duration | 手势识别器的触发长按的最短时间。单位为ms。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |

### OH\_ArkUI\_GetGestureParam\_angle()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureParam_angle(ArkUI_GestureRecognizer* recognizer, double* angle)
```

**描述：**

获取手势识别器的旋转手势的最小改变度数。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| double\* angle | 手势识别器的旋转手势的最小改变度数。单位为deg。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |

### OH\_ArkUI\_GetGestureParam\_distanceThreshold()

PhonePC/2in1TabletTVWearable



```
1. int32_t OH_ArkUI_GetGestureParam_distanceThreshold(ArkUI_GestureRecognizer* recognizer, double* distanceThreshold)
```

**描述：**

获取手势识别器的手势移动阈值。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| double\* distanceThreshold | 手势识别器的手势移动阈值。单位：px。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |

### OH\_ArkUI\_PanGesture\_SetDistanceMap()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_PanGesture_SetDistanceMap(ArkUI_GestureRecognizer* recognizer, int size, int* toolTypeArray, double* distanceArray)
```

**描述：**

设置手势最小滑动阈值表。

**起始版本：** 19

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| int size | 手势最小滑动阈值数组的大小。 |
| int\* toolTypeArray | 指向输入事件的工具类型数组的指针。当设置[UI\_INPUT\_EVENT\_TOOL\_TYPE\_XXX](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ui-input-event-h#anonymous2)以外的值时，设置不生效。 |
| double\* distanceArray | 指向最小滑动阈值数组的指针。单位为px。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  返回 [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  返回 [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。  返回 [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |

### OH\_ArkUI\_PanGesture\_GetDistanceByToolType()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_PanGesture_GetDistanceByToolType(ArkUI_GestureRecognizer* recognizer, int toolType, double* distance)
```

**描述：**

获取手势识别器的手势移动阈值表。仅支持对通过OH\_ArkUI\_PanGesture\_SetDistanceMap修改过的设备类型的阈值查询。默认滑动阈值可通过查询[UI\_INPUT\_EVENT\_TOOL\_TYPE\_UNKNOWN](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-ui-input-event-h#anonymous2)类型获得，其他未设置过的类型不会返回。

**起始版本：** 19

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| int toolType | 输入事件的工具类型。 |
| double\* distance | 手势识别器的手势移动阈值。单位为px。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  返回 [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  返回 [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。  返回 [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |

### OH\_ArkUI\_SetTouchTestDoneCallback()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_SetTouchTestDoneCallback(ArkUI_NodeHandle node, void* userData, void (*touchTestDone)(ArkUI_GestureEvent* event, ArkUI_GestureRecognizerHandleArray recognizers, int32_t count, void* userData))
```

**描述：**

注册一个在所有手势识别器收集完成后执行的回调函数。当用户开始触摸屏幕时，系统会进行命中测试并根据触摸位置收集手势识别器。随后，在处理任何移动事件之前，组件可以使用此接口确定将参与识别并相互竞争的手势识别器。

**起始版本：** 20

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_NodeHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-node8h) node | 需要设置手势收集完成回调的节点句柄。 |
| void\* userData | 用户自定义数据。 |
| void (\*touchTestDone)([ArkUI\_GestureEvent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureevent)\* event, [ArkUI\_GestureRecognizerHandleArray](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ui-nativemodule-arkui-gesturerecognizerhandlearray) recognizers, int32\_t count, void\* userData) | 手势收集完成的回调函数。event为手势的基本信息，recognizers为手势识别器数组，count为手势识别器个数，userData为用户自定义数据。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  返回 [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  返回 [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。 |

### OH\_ArkUI\_GestureInterrupter\_GetUserData()

PhonePC/2in1TabletTVWearable



```
1. void* OH_ArkUI_GestureInterrupter_GetUserData(ArkUI_GestureInterruptInfo* event)
```

**描述：**

获取手势中断事件中的用户自定义数据。

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureInterruptInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gestureinterruptinfo)\* event | 是指向手势中断信息的指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| void\* | 返回指向用户自定义数据的指针。 |

### OH\_ArkUI\_PreventGestureRecognizerBegin()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_PreventGestureRecognizerBegin(ArkUI_GestureRecognizer* recognizer)
```

**描述：**

在手指全部抬起前阻止手势识别器参与当前手势识别。如果系统已确定该手势识别器的结果（无论成功与否），调用此接口将无效。

**起始版本：** 20

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  返回 [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  返回 [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。 |

### OH\_ArkUI\_LongPressGesture\_SetAllowableMovement()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_LongPressGesture_SetAllowableMovement(ArkUI_GestureRecognizer* recognizer, double allowableMovement)
```

**描述：**

设置长按手势识别器识别的手势的最大移动距离。

**起始版本：** 22

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| double allowableMovement | 长按手势识别器识别的手势的最大移动距离。  单位为px。  取值范围：(0, +∞)，设置小于等于0时，按照默认值15处理。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。  [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |

### OH\_ArkUI\_LongPressGesture\_GetAllowableMovement()

PhonePC/2in1TabletTVWearable



```
1. ArkUI_ErrorCode OH_ArkUI_LongPressGesture_GetAllowableMovement(ArkUI_GestureRecognizer* recognizer, double* allowableMovement)
```

**描述：**

获取长按手势识别器识别的手势的最大移动距离。

**起始版本：** 22

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [ArkUI\_GestureRecognizer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-arkui-nativemodule-arkui-gesturerecognizer)\* recognizer | 手势识别器指针。 |
| double\* allowableMovement | 指向长按手势识别器识别的手势的最大移动距离的指针。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [ArkUI\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) | 错误码。  [ARKUI\_ERROR\_CODE\_NO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 成功。  [ARKUI\_ERROR\_CODE\_PARAM\_INVALID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 参数错误。  [ARKUI\_ERROR\_CODE\_RECOGNIZER\_TYPE\_NOT\_SUPPORTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#arkui_errorcode) 不支持手势识别器类型。 |