Android 2.3 r1 中文 API （57） —— ScaleGestureDetector

前言

　　本章內容是 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/
 

 

正文

　　1、結構

public class ScaleGestureDetector extends Object

      

java.lang.Object

android.view.ScaleGestureDetector

 

　　2、概述
 

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

　　　　爲你的View建立ScaleGestureDetector 實例

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

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

 

　　3、內部類

　　　　interface ScaleGestureDetector.OnScaleGestureListener    

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

 

　　　　class         ScaleGestureDetector.SimpleOnScaleGestureListener 

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

 

　　4、構造函數

　　　　public ScaleGestureDetector (Context context, ScaleGestureDetector.OnScaleGestureListener listener)

       　 構造函數

 

　　5、公共方法

　　　　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。

 

　　6、補充

　　　　文章精選

           　　android touchexample （中文）

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

 

結束
 

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