此项为 API 级别 XE12 中的新增配置
一个手势传感器,专门用于识别触控板的触摸手势。
存在离散手势监听器(例如,GestureDetector.BaseListener
、GestureDetector.FingerListener
)和连续手势监听器(例如,GestureDetector.ScrollListener
、GestureDetector.OneFingerScrollListener
、GestureDetector.TwoFingerScrollListener
)。
如需了解详情,请参阅轻触手势开发者指南。
常规用法
- 实现任何所需的监听器接口,并在
GestureDetector
上设置这些接口。 - 替换
onGenericMotionEvent(MotionEvent)
或dispatchGenericFocusedEvent(MotionEvent)
等输入事件回调,并将MotionEvent
传递给手势检测器的onMotionEvent(MotionEvent)
方法,以处理事件。 - 在手势检测器监听器中正确处理事件。
注意:在为监听器实现
onXXX
方法时,只有在您不想将MotionEvent
分派给输入调度流水线中的任何其他监听实体时,才应将其值设置为true
。
嵌套类 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
接口 | GestureDetector.BaseListener | 接收检测结果。 | |||||||||
接口 | GestureDetector.FingerListener | 此监听器会在检测到的指纹在触控板上发生变化时报告。 | |||||||||
接口 | GestureDetector.OneFingerScrollListener | 此监听器可接收单指连续滚动事件。 | |||||||||
接口 | GestureDetector.ScrollListener | 该监听器会接收与手指数量无关的连续水平滚动事件。 | |||||||||
接口 | GestureDetector.TwoFingerScrollListener | 此监听器会接收连续的双指水平滚动事件。 |
公共构造函数 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
GestureDetector(上下文上下文)
|
公共方法 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
static 布尔值 | |||||||||||
static 布尔值 |
isForward(浮点数增量)
|
||||||||||
布尔值 | |||||||||||
GestureDetector |
setAlwaysConsumeEvents(已启用布尔值)
|
||||||||||
GestureDetector | |||||||||||
GestureDetector | |||||||||||
GestureDetector | |||||||||||
GestureDetector | |||||||||||
GestureDetector |
继承的方法 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
公共构造函数
公共方法
在 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监听器)
设置可检测水平滚动和双指滚动的监听器。