手勢偵測器

已新增至 API 級別 XE12

專為辨識觸控板手勢而最佳化的手勢偵測工具。

也有獨立的手勢事件監聽器 (例如GestureDetector.BaseListener、GestureDetector.FingerListener) 和連續手勢事件監聽器 (例如GestureDetector.ScrollListener、GestureDetector.OneFingerScrollListener、GestureDetector.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(Context 內容)
公用方法
static 布林值
isForward(手勢手勢)
static 布林值
isForward(浮點差異值)
布林值
onMotionEvent(MotionEvent 事件)
GestureDetector
setAlwaysConsumeEvents(啟用布林值)
GestureDetector
setBaseListener(GestureDetector.BaseListener 事件監聽器)
GestureDetector
setFingerListener(GestureDetector.FingerListener 事件監聽器)
GestureDetector
setOneFingerScrollListener(GestureDetector.OneFingerScrollListener 事件監聽器)
GestureDetector
setScrollListener(GestureDetector.ScrollListener 事件監聽器)
GestureDetector
setTwoFingerScrollListener(GestureDetector.TwoFingerScrollListener 事件監聽器)
繼承的方法

公用建構函式

已新增至 API 級別 XE12

公開 GestureDetector (Context 內容)

公用方法

已新增至 API 級別 XE16

public static 布林值 isForward (手勢手勢)

如果指定的手勢對應到觸控板上的向前動作，則傳回 true。

這個方法只適用於橫向滑動，且在其他手勢上呼叫時，則會擲回例外狀況。

已新增至 API 級別 XE16

public static 布林值 isForward (float deltaX)

如果指定的位移對應觸控板上的向前動作，則傳回 true。

已新增至 API 級別 XE12

public 布林值 onMotionEvent (MotionEvent 事件)

處理動作事件，如果應一律使用事件或偵測到手勢，則傳回 true。

傳回
  • 可反映出是否使用觸控事件
已新增至 API 級別 XE12

public GestureDetector setAlwaysConsumeEvents (boolean enabled)

設定手勢偵測工具是否應使用傳遞至 onMotionEvent(MotionEvent) 的事件，無論事件是否實際進行處理都一樣。

已新增至 API 級別 XE12

public GestureDetector setBaseListener (GestureDetector.BaseListener 事件監聽器)

設定基本手勢事件監聽器。

已新增至 API 級別 XE12

public GestureDetector setFingerListener (GestureDetector.FingerListener 事件監聽器)

設定手指事件監聽器。

已新增至 API 級別 XE21

public GestureDetector setOneFingerScrollListener (GestureDetector.OneFingerScrollListener 事件監聽器)

設定可偵測水平和單指捲動的事件監聽器。

已新增至 API 級別 XE12

public GestureDetector setScrollListener (GestureDetector.ScrollListener 事件監聽器)

設定監聽器，用於偵測水平捲動的情形，不受手指計數影響。

已新增至 API 級別 XE12

public GestureDetector setTwoFingerScrollListener (GestureDetector.TwoFingerScrollListener 事件監聽器)

設定可偵測水平和雙指捲動的事件監聽器。