# PanGesture >![](../../public_sys-resources/icon-note.gif) **说明:** >从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 ## 权限列表 无 ## 接口 PanGesture\(options?: \{ fingers?: number, direction?: PanDirection, distance?: number \} | [PanGestureOption](#section14214195212149)\) - 参数
参数名称 |
参数类型 |
必填 |
默认值 |
参数描述 |
---|---|---|---|---|
fingers |
number |
否 |
1 |
触发滑动的最少手指数,最小为1指, 最大取值为10指。 |
direction |
否 |
All |
设置滑动方向,此枚举值支持逻辑与(&)和逻辑或(|)运算。 |
|
distance |
number |
否 |
5.0 |
最小滑动识别距离,单位为vp。 |
名称 |
描述 |
---|---|
All |
所有方向可滑动。 |
Horizontal |
水平方向可滑动。 |
Vertical |
竖直方向可滑动。 |
Left |
向左滑动。 |
Right |
向右滑动。 |
Up |
向上滑动。 |
Down |
向下滑动。 |
None |
任何方向都不可滑动。 |
名称 |
功能描述 |
---|---|
setDirection(value: PanDirection) |
设置direction属性。 |
setDistance(value: number) |
设置distance属性。 |
setFingers(value: number) |
设置fingers属性。 |
名称 |
功能描述 |
|
---|---|---|
onActionStart(callback: (event?: PanGestureEvent) => void) |
Pan手势识别成功回调。 |
|
onActionUpdate(callback: (event?: PanGestureEvent) => void) |
Pan手势移动过程中回调。 |
|
onActionEnd(callback: (event?: PanGestureEvent) => void) |
Pan手势识别成功,手指抬起后触发回调。 |
|
onActionCancel(callback: () => void) |
Pan手势识别成功,接收到触摸取消事件触发回调。 |
属性名称 |
属性类型 |
描述 |
---|---|---|
offsetX |
number |
手势事件偏移量,单位为vp。 |
offsetY |
number |
手势事件偏移量,单位为vp。 |