安卓开发笔记（四）onTouchEvent方法的使用

手机屏幕事件的处理方法onTouchEvent。该方法在View类中的定义，并且所有的View子类全部重写了该方法，应用程序可以通过该方法处理手机屏幕的触摸事件。该方法的签名如下所示。

public boolean onTouchEvent(MotionEvent event)   

参数event：参数event为手机屏幕触摸事件封装类的对象，其中封装了该事件的所有信息，例如触摸的位置、触摸的类型以及触摸的时间等。该对象会在用户触摸手机屏幕时被创建。

返回值：该方法的返回值机理与键盘响应事件的相同，同样是当已经完整地处理了该事件且不希望其他回调方法再次处理时返回true，否则返回false。

该方法并不像之前介绍过的方法只处理一种事件，一般情况下以下三种情况的事件全部由onTouchEvent方法处理，只是三种情况中的动作值不同。

屏幕被按下：当屏幕被按下时，会自动调用该方法来处理事件，此时MotionEvent.getAction()的值为MotionEvent.ACTION_DOWN，如果在应用程序中需要处理屏幕被按下的事件，只需重新该回调方法，然后在方法中进行动作的判断即可。

屏幕被抬起：当触控笔离开屏幕时触发的事件，该事件同样需要onTouchEvent方法来捕捉，然后在方法中进行动作判断。当MotionEvent.getAction()的值为MotionEvent.ACTION_UP时，表示是屏幕被抬起的事件。

在屏幕中拖动：该方法还负责处理触控笔在屏幕上滑动的事件，同样是调用MotionEvent.getAction()方法来判断动作值是否为MotionEvent.ACTION_MOVE再进行处理。

Android Touch Screen 与传统Click Touch Screen不同，会有一些手势(Gesture)，例如Fling，Scroll等等。这些Gesture会使用户体验大大提升。
Android中的Gesture识别(detector)是通过GestureDetector.OnGestureListener接口实现的。
首先，Android事件处理机制是基于Listener实现的，比如触摸屏相关的事件，就是通过onTouchListener实现；
其次，所有View的子类都可以通过setOnTouchListener()、setOnKeyListener()等方法来添加对某一类事件的Listener；
第三，Listener一般会以Interface的方式来提供，其中包含一个或多个abstract方法，我们需要实现这些方法来完成 onTouch()、onKey()等操作。这样，程序便可以在特定的事件被dispatch到该view的时候，通过callback函数给予适当的响 应。

1. Touch Screen Click举例

public class MyGesture extends Activity implements OnTouchListener  
{  
 public void onCreate(Bundle savedInstanceState)  
 {  
  super.onCreate(savedInstanceState);  
  
  setContentView(R.layout.main);  
  
  TextView tv = (TextView) findViewById(R.id.tv);  
  
  tv.setOnTouchListener(this);  
 }  
 public boolean onTouch(View v, MotionEvent event)  
  
 {  
  Toast.makeText(this, "Touch Touch", Toast.LENGTH_SHORT).show();  
  
  return false;  
 }  
  
}  

我们可以通过MotionEvent的getAction()方法来获取Touch事件的类型，包括 ACTION_DOWN（按下触摸屏）, ACTION_MOVE（按下触摸屏后移动受力点）, ACTION_UP（松开触摸屏）和ACTION_CANCEL（不会由用户直接触发）。借助对于用户不同操作的判断，结合getRawX()、 getRawY()、getX()和getY()等方法来获取坐标后，我们可以实现诸如拖动某一个按钮，拖动滚动条等功能。2. 当我们捕捉到Touch操作的时候，如何识别出用户的Gesture？这里我们需要GestureDetector.OnGestureListener接口的帮助，代码如下：

public class MyGesture extends Activity implements OnTouchListener,  
        OnGestureListener  
  
{  
  
    private GestureDetector mGestureDetector;  
  
    public MyGesture()  
  
    {  
  
        mGestureDetector = new GestureDetector(this);  
  
    }  
  
    public void onCreate(Bundle savedInstanceState)  
  
    {  
  
        super.onCreate(savedInstanceState);  
  
        setContentView(R.layout.main);  
  
        TextView tv = (TextView) findViewById(R.id.tv);  
  
        tv.setOnTouchListener(this);  
  
        tv.setFocusable(true);  
  
        tv.setClickable(true);  
  
        tv.setLongClickable(true);  
  
        mGestureDetector.setIsLongpressEnabled(true);  
  
    }  
  
    /*        
     * *在onTouch()方法中，我们调用GestureDetector的onTouchEvent()方法， 
     * 将捕捉到的MotionEvent交给GestureDetector * 来分析是否有合适的callback函数来处理用户的手势 
     */  
  
    public boolean onTouch(View v, MotionEvent event)  
  
    {  
  
        return mGestureDetector.onTouchEvent(event);  
  
    }  
  
    // 用户轻触触摸屏，由1个MotionEvent ACTION_DOWN触发  
  
    public boolean onDown(MotionEvent arg0)  
  
    {  
  
        Log.i("MyGesture", "onDown");  
  
        Toast.makeText(this, "onDown", Toast.LENGTH_SHORT).show();  
  
        return true;  
  
    }  
  
    /*        
     * * 用户轻触触摸屏，尚未松开或拖动，由一个1个MotionEvent ACTION_DOWN触发 * 
     * 注意和onDown()的区别，强调的是没有松开或者拖动的状态 
     */  
  
    public void onShowPress(MotionEvent e)  
  
    {  
  
        Log.i("MyGesture", "onShowPress");  
  
        Toast.makeText(this, "onShowPress", Toast.LENGTH_SHORT).show();  
  
    }  
  
    // 用户（轻触触摸屏后）松开，由一个1个MotionEvent ACTION_UP触发  
  
    public boolean onSingleTapUp(MotionEvent e)  
  
    {  
  
        Log.i("MyGesture", "onSingleTapUp");  
  
        Toast.makeText(this, "onSingleTapUp", Toast.LENGTH_SHORT).show();  
  
        return true;  
  
    }  
  
    // 用户按下触摸屏、快速移动后松开，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE, 1个ACTION_UP触发  
  
    public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
            float velocityY)  
  
    {  
  
        Log.i("MyGesture", "onFling");  
  
        Toast.makeText(this, "onFling", Toast.LENGTH_LONG).show();  
  
        return true;  
  
    }  
  
    // 用户按下触摸屏，并拖动，由1个MotionEvent ACTION_DOWN, 多个ACTION_MOVE触发  
  
    public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX,  
            float distanceY)  
  
    {  
  
        Log.i("MyGesture", "onScroll");  
  
        Toast.makeText(this, "onScroll", Toast.LENGTH_LONG).show();  
  
        return true;  
  
    }  
  
    // 用户长按触摸屏，由多个MotionEvent ACTION_DOWN触发  
  
    public void onLongPress(MotionEvent e)  
  
    {  
  
        Log.i("MyGesture", "onLongPress");  
  
        Toast.makeText(this, "onLongPress", Toast.LENGTH_LONG).show();  
  
    }  
  
}  

3. Fling事件的处理代码：除了第一个触发Fling的ACTION_DOWN和最后一个ACTION_MOVE中包含的坐标等信息外，我们还可以根据用 户在X轴或者Y轴上的移动速度作为条件。比如下面的代码中我们就在用户移动超过100个像素，且X轴上每秒的移动速度大于200像素时才进行处理。

public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,  
            float velocityY)  
  
    {  
  
        // 参数解释：  
  
        // e1：第1个ACTION_DOWN MotionEvent  
  
        // e2：最后一个ACTION_MOVE MotionEvent  
  
        // velocityX：X轴上的移动速度，像素/秒  
  
        // velocityY：Y轴上的移动速度，像素/秒  
  
        // 触发条件 ：  
  
        // X轴的坐标位移大于FLING_MIN_DISTANCE，且移动速度大于FLING_MIN_VELOCITY个像素/秒  
  
        final int FLING_MIN_DISTANCE = 100, FLING_MIN_VELOCITY = 200;  
  
        if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE  
                && Math.abs(velocityX) > FLING_MIN_VELOCITY)  
  
        {  
  
            // Fling left  
  
            Log.i("MyGesture", "Fling left");  
  
            Toast.makeText(this, "Fling Left", Toast.LENGTH_SHORT).show();  
  
        }  
  
        else if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE  
                && Math.abs(velocityX) > FLING_MIN_VELOCITY)  
  
        {  
  
            // Fling right  
  
            Log.i("MyGesture", "Fling right");  
  
            Toast.makeText(this, "Fling Right", Toast.LENGTH_SHORT).show();  
  
        }  
  
        return false;  
  
    }  

这个例子中，tv.setLongClickable(true)是必须的，因为 只有这样，view才能够处理不同于Tap（轻触）的hold（即ACTION_MOVE，或者多个ACTION_DOWN），我们同样可以通过layout定义中的android:longClickable来做到这一点.