GestureDetector

此项为 API 级别 XE12 中的新增配置

一个手势传感器,专门用于识别触控板的触摸手势。

存在离散手势监听器(例如,GestureDetector.BaseListenerGestureDetector.FingerListener)和连续手势监听器(例如,GestureDetector.ScrollListenerGestureDetector.OneFingerScrollListenerGestureDetector.TwoFingerScrollListener)。

如需了解详情,请参阅轻触手势开发者指南。

常规用法

  1. 实现任何所需的监听器接口,并在 GestureDetector 上设置这些接口。
  2. 替换 onGenericMotionEvent(MotionEvent)dispatchGenericFocusedEvent(MotionEvent) 等输入事件回调,并将 MotionEvent 传递给手势检测器的 onMotionEvent(MotionEvent) 方法,以处理事件。
  3. 在手势检测器监听器中正确处理事件。

    注意:在为监听器实现 onXXX 方法时,只有在您不想将 MotionEvent 分派给输入调度流水线中的任何其他监听实体时,才应将其值设置为 true

嵌套类
接口 GestureDetector.BaseListener 接收检测结果。
接口 GestureDetector.FingerListener 此监听器会在检测到的指纹在触控板上发生变化时报告。
接口 GestureDetector.OneFingerScrollListener 此监听器可接收单指连续滚动事件。
接口 GestureDetector.ScrollListener 该监听器会接收与手指数量无关的连续水平滚动事件。
接口 GestureDetector.TwoFingerScrollListener 此监听器会接收连续的双指水平滚动事件。
公共构造函数
GestureDetector上下文上下文)
公共方法
static 布尔值
isForward手势手势)
static 布尔值
isForward(浮点数增量)
布尔值
GestureDetector
setAlwaysConsumeEvents(已启用布尔值)
GestureDetector
GestureDetector
GestureDetector
GestureDetector
GestureDetector
继承的方法

公共构造函数

在 API 级别 XE12 中添加

public GestureDetector (Context context)

公共方法

在 API 级别 XE16 中添加

public static 布尔值 isForward(Gesture 手势)

如果指定的手势对应于触控板上的前向运动,则返回 true

此方法仅适用于侧面滑动,如果在其他手势上调用,则会抛出异常。

在 API 级别 XE16 中添加

public static boolean isForward (float deltaX)

如果指定的移位对应于触控板上的向前移动,则返回 true

在 API 级别 XE12 中添加

public 布尔值 onMotionEvent MotionEvent 事件)

处理动作事件,如果应始终使用相应事件或检测到手势,则返回 true

返回
  • 反映是否使用了触摸事件
在 API 级别 XE12 中添加

public GestureDetector setAlwaysConsumeEvents (已启用布尔值)

设置手势检测器是否应使用传递给 onMotionEvent(MotionEvent) 的事件(无论是否实际处理)。

在 API 级别 XE12 中添加

public GestureGestureDetector setBaseListener (GestureDetector.BaseListener 监听器)

设置基本手势监听器。

在 API 级别 XE12 中添加

public GestureDetectorsetFingerListener (GestureDetector.FingerListener监听器)

设置手指监听器。

在 API 级别 XE21 中添加

public GestureDetector setOneFingerScrollListener (GestureDetector.OneFingerScrollListener监听器)

设置可水平检测和单指滚动的监听器。

在 API 级别 XE12 中添加

public GestureDetector setScrollListener (GestureDetector.ScrollListener 监听器)

设置可检测水平滚动而不依赖于手指计数的监听器。

在 API 级别 XE12 中添加

public GestureDetector setTwoFingerScrollListener (GestureDetector.TwoFingerScrollListener监听器)

设置可检测水平滚动和双指滚动的监听器。