手勢偵測器

已新增至 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(情境)

公用方法
靜態 布林值	isForward(Gesture 手勢)
靜態 布林值	isForward(float deltaX)
布林值	onMotionEvent (MotionEvent 事件)
手勢偵測器	setAlwaysConsumeEvents (已啟用布林值)
手勢偵測器	setBaseListener(GestureDetector.BaseListener 事件監聽器)
手勢偵測器	setFingerListener(GestureDetector.FingerListener 事件監聽器)
手勢偵測器	setOneFingerScrollListener(GestureDetector.OneFingerScrollListener 事件監聽器)
手勢偵測器	setScrollListener (GestureDetector.ScrollListener 事件監聽器)
手勢偵測器	setTwoFingerScrollListener(GestureDetector.TwoFingerScrollListener 事件監聽器)

繼承方法
從 java.lang.Object 類別 物件 clone() 布林值 等於(物件 arg0) void finalize() 結束 課程<?> getClass() 整數 hashCode() 最終 void notify() 最終 void notifyAll() 字串 toString() 最終 void wait() 最終 void wait(long arg0, int arg1) 最終 void wait(long arg0)

公用建構函式

已新增至 API 等級 XE12

public DetectDetector (結構定義結構定義)

公用方法

已新增至 API 等級 XE16

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

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

這個方法只有在進行其他滑動時，才適用橫向滑動，並擲回例外狀況。

已新增至 API 等級 XE16

public static 布林值 isForward (float deltaX)

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

已新增至 API 等級 XE12

公開 布林值 onMotionEvent (MotionEvent 事件)

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

傳回

• 會反映出使用者是否已耗用觸控事件

已新增至 API 等級 XE12

public 手勢偵測器setAlwaysConsumeEvents(已啟用布林值)

設定手勢偵測工具應使用傳送至 onMotionEvent(MotionEvent) 的事件，不論其是否確實已處理。

已新增至 API 等級 XE12

public 手勢偵測器setBaseListener(GestureDetector.BaseListener 事件監聽器)

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

已新增至 API 等級 XE12

public 手勢偵測工具setFingerListener(GestureDetector.FingerListener 事件監聽器)

設定手指事件監聽器。

已新增至 API 等級 XE21

public 手勢偵測器setOneFingerScrollListener(GestureDetector.OneFingerScrollListener 事件監聽器)

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

已新增至 API 等級 XE12

public 手勢偵測器setScrollListener(GestureDetector.ScrollListener 事件監聽器)

設定可偵測水平捲動的監聽器，且不受手指計數影響。

已新增至 API 等級 XE12

public 手勢偵測器setTwoFingerScrollListener(GestureDetector.TwoFingerScrollListener 事件監聽器)

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