前言

　　本章內容是 android.view.ScaleGestureDetector，允許Views可以通過提供的MotionEvents檢測和處理包括多點觸摸在內的手勢變化信息，版本為Android 2.3 r1，翻譯來自"一昕"，再次感謝"一昕" ！期待你一起參與Android中文API的翻譯，聯系我over140@gmail.com。

?

聲明

　　歡迎轉載，但請保留文章原始出處:)
?

　　　　農民伯伯：http://over140.blog.51cto.com/

　　　　Android中文翻譯組：http://code.taobao.org/project/view/404/
?

?

正文

　　一、結構

public class ScaleGestureDetector extends Object

??????

java.lang.Object

android.view.ScaleGestureDetector

?

　　二、概述
?

　　根據接收的MotionEvent, 偵測由多個觸點（多點觸控）引發的變形手勢。callback方法ScaleGestureDetector.OnScaleGestureListener 會在特定手勢事件發生時通知用戶。該類僅能和Touch事件引發的MotionEvent配合使用。使用該類需要

　　　　為你的View創建ScaleGestureDetector 實例

　　　　確保在onTouchEvent(MotionEvent)方法中調用 onTouchEvent (MotionEvent). [譯者注：前者為該類的onTouchEvent方法，后者為View的onTouchEvent方法。] 在事件發生時，定義在callback中的方法會被調用。

　　　　（譯者注：ScaleGestureDetector為Android2.2新增的類，允許Views可以通過提供的MotionEvents檢測和處理包括多點觸摸在內的手勢變化信息。）

?

　　三、內部類

　　　　interface?ScaleGestureDetector.OnScaleGestureListener????

　　手勢發生時接收通知的監聽器

?

　　　　class???????? ScaleGestureDetector.SimpleOnScaleGestureListener?

　　一個方便使用的類。 若僅想監聽一部分尺寸伸縮事件，可繼承該類。

?

　　四、構造函數

　　　　public ScaleGestureDetector (Context context, ScaleGestureDetector.OnScaleGestureListener listener)

?????? 　 構造函數

?

　　五、公共方法

　　　　public float getCurrentSpan ()

　　返回手勢過程中，組成該手勢的兩個觸點的當前距離。

　　返回值

　　以像素為單位的觸點距離。

?

　　　　public long getEventTime ()

　　返回事件被捕捉時的時間。

　　返回值

　　以毫秒為單位的事件時間。

?

　　　　public float getFocusX ()

　　返回當前手勢焦點的X坐標。 如果手勢正在進行中，焦點位于組成手勢的兩個觸點之間。 如果手勢正在結束，焦點為仍留在屏幕上的觸點的位置。若isInProgress（）返回false，該方法的返回值未定義。

　　返回值

　　返回焦點的X坐標值，以像素為單位。

?

　　　　public float getFocusY ()

　　返回當前手勢焦點的Y坐標。 如果手勢正在進行中，焦點位于組成手勢的兩個觸點之間。 如果手勢正在結束，焦點為仍留在屏幕上的觸點的位置。若isInProgress（）返回false，該方法的返回值未定義。

　　返回值

　　返回焦點的Y坐標值，以像素為單位。

?

　　　　public float getPreviousSpan ()

　　返回手勢過程中，組成該手勢的兩個觸點的前一次距離。

　　返回值

　　兩點的前一次距離，以像素為單位。

?

　　　　public float getScaleFactor ()

　　返回從前一個伸縮事件至當前伸縮事件的伸縮比率。該值定義為 (getCurrentSpan() / getPreviousSpan())。

　　返回值

　　當前伸縮比率.

?

　　　　public long getTimeDelta ()

　　返回前一次接收到的伸縮事件距當前伸縮事件的時間差，以毫秒為單位。

　　返回值

　　從前一次伸縮事件起始的時間差，以毫秒為單位。

?

　　　　public boolean isInProgress ()

　　如果手勢處于進行過程中，返回true.

　　返回值

　　如果手勢處于進行過程中，返回true。否則返回false。

?

　　六、補充

　　　　文章精選

?????????? 　　android touchexample （中文）

?????????? 　　Making Sense of Multitouch（android-developers.blogspot.com）

?

結束
?

　　昨天(2010-12-7)Android 2.3 r1已經發布，翻譯組也迅速的切換到新版本的翻譯，所有新翻譯的章節均為最新版本。本文為試審核員"一昕"的翻譯稿，接下來他將開始試審核工作，感謝他的努力和貢獻 :)
?

總結

以上是生活随笔為你收集整理的Android 2.3 r1 中文 API （57） —— ScaleGestureDetector的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。