onInterceptTouchEvent () 是 ViewGroup 的一个方法,目的是在系统向该 ViewGroup 及其各个 childView 触发 onTouchEvent() 之前对相关事件进行一次拦截, Android 这么设计的想法也很好理解,由于 ViewGroup 会包含若干 childView, 因此需要能够统一监控各种 touch 事件的机会,因此纯粹的不能包含子 view 的控件是没有这个方法的,如 LinearLayout 就有, TextView 就没有。
onInterceptTouchEvent () 使用也很简单,如果在 ViewGroup 里覆写了该方法,那么就可以对各种 touch 事件加以拦截。但是如何拦截,是否所有的 touch 事件都需要拦截则是比较复杂的, touch 事件在 onInterceptTouchEvent() 和 onTouchEvent 以及各个 childView 间的传递机制完全取决于 onInterceptTouchEvent() 和 onTouchEvent() 的返回值。并且,针对 down 事件处理的返回值直接影响到后续 move 和 up 事件的接收和传递。
关于返回值的问题,基本规则很清楚,如果 return true, 那么表示该方法消费了此次事件,如果 return false ,那么表示该方法并未处理完全,该事件仍然需要以某种方式传递下去继续等待处理。
SDK 给出的说明如下:
· You will receive the down event here.
· The down event will be handled either by a child of this view group, or given to your own onTouchEvent() method to handle; this means you should implement onTouchEvent() to return true, so you will continue to see the rest of the gesture (instead of looking for a parent view to handle it). Also, by returning true from onTouchEvent(), you will not receive any following events in onInterceptTouchEvent() and all touch processing must happen in onTouchEvent() like normal.
· For as long as you return false from this function, each following event (up to and including the final up) will be delivered first here and then to the target's onTouchEvent().
· If you return true from here, you will not receive any following events: the target view will receive the same event but with the action ACTION_CANCEL , and all further events will be delivered to your onTouchEvent() method and no longer appear here.
由于 onInterceptTouchEvent() 的机制比较复杂,上面的说明写的也比较复杂,总结一下,基本的规则是:
1. down 事件首先会传递到 onInterceptTouchEvent() 方法
2. 如果该 ViewGroup 的 onInterceptTouchEvent() 在接收到 down 事件处理完成之后 return false ,那么后续的 move, up 等事件将继续会先传递给该 ViewGroup ,之后才和 down 事件一样传递给最终的目标 view 的 onTouchEvent() 处理。
3. 如果该 ViewGroup 的 onInterceptTouchEvent() 在接收到 down 事件处理完成之后 return true ,那么后续的 move, up 等事件将不再传递给 onInterceptTouchEvent() ,而是和 down 事件一样传递给该 ViewGroup 的 onTouchEvent() 处理,注意,目标 view 将接收不到任何事件。
4. 如果最终需要处理事件的 view 的 onTouchEvent() 返回了 false ,那么该事件将被传递至其上一层次的 view 的 onTouchEvent() 处理。
5. 如果最终需要处理事件的 view 的 onTouchEvent() 返回了 true ,那么后续事件将可以继续传递给该 view 的 onTouchEvent() 处理。
下面用一个简单的实验说明上述复杂的规则。视图自底向上共 3 层,其中 LayoutView1 和 LayoutView2 就是 LinearLayout , MyTextView 就是 TextView :
对应的 xml 布局文件如下:
下面看具体情况:
1. onInterceptTouchEvent() 处理 down 事件均返回 false , onTouchEvent() 处理事件均返回 true
------------------------------------------------------------------------------------------------------------------------------
04-11 03:58:42.620: DEBUG/LayoutView1(614): onInterceptTouchEvent action:ACTION_DOWN
04-11 03:58:42.620: DEBUG/LayoutView2(614): onInterceptTouchEvent action:ACTION_DOWN
04-11 03:58:42.620: DEBUG/MyTextView(614): onTouchEvent action:ACTION_DOWN
04-11 03:58:42.800: DEBUG/LayoutView1(614): onInterceptTouchEvent action:ACTION_MOVE
04-11 03:58:42.800: DEBUG/LayoutView2(614): onInterceptTouchEvent action:ACTION_MOVE
04-11 03:58:42.800: DEBUG/MyTextView(614): onTouchEvent action:ACTION_MOVE
…… // 省略过多的 ACTION_MOVE
04-11 03:58:43.130: DEBUG/LayoutView1(614): onInterceptTouchEvent action:ACTION_UP
04-11 03:58:43.130: DEBUG/LayoutView2(614): onInterceptTouchEvent action:ACTION_UP
04-11 03:58:43.150: DEBUG/MyTextView(614): onTouchEvent action:ACTION_UP
------------------------------------------------------------------------------------------------------------------------------
这是最常见的情况, onInterceptTouchEvent 并没有做任何改变事件传递时序的操作,效果上和没有覆写该方法是一样的。可以看到,各种事件的传递本身是自底向上的,次序是: LayoutView1->LayoutView2->MyTextView 。注意,在 onInterceptTouchEvent 均返回 false 时, LayoutView1 和 LayoutView2 的 onTouchEvent 并不会收到事件 ,而是最终传递给了 MyTextView 。
2. LayoutView1 的 onInterceptTouchEvent() 处理 down 事件返回 true ,
MyTextView 的 onTouchEvent() 处理事件返回 true
------------------------------------------------------------------------------------------------------------------------------
04-11 03:09:27.589: DEBUG/LayoutView1(446): onInterceptTouchEvent action:ACTION_DOWN
04-11 03:09:27.589: DEBUG/LayoutView1(446): onTouchEvent action:ACTION_DOWN
04-11 03:09:27.629: DEBUG/LayoutView1(446): onTouchEvent action:ACTION_MOVE
04-11 03:09:27.689: DEBUG/LayoutView1(446): onTouchEvent action:ACTION_MOVE
…… // 省略过多的 ACTION_MOVE
04-11 03:09:27.959: DEBUG/LayoutView1(446): onTouchEvent action:ACTION_UP
------------------------------------------------------------------------------------------------------------------------------
从 Log 可以看到,由于 LayoutView1 在拦截第一次 down 事件时 return true ,所以后续的事件(包括第一次的 down )将由 LayoutView1 本身处理,事件不再传递下去。
3. LayoutView1 , LayoutView2 的 onInterceptTouchEvent() 处理 down 事件返回 false ,
MyTextView 的 onTouchEvent() 处理事件返回 false
LayoutView2 的 onTouchEvent() 处理事件返回 true
----------------------------------------------------------------------------------------------------------------------------
04-11 09:50:21.147: DEBUG/LayoutView1(301): onInterceptTouchEvent action:ACTION_DOWN
04-11 09:50:21.147: DEBUG/LayoutView2(301): onInterceptTouchEvent action:ACTION_DOWN
04-11 09:50:21.147: DEBUG/MyTextView(301): onTouchEvent action:ACTION_DOWN
04-11 09:50:21.147: DEBUG/LayoutView2(301): onTouchEvent action:ACTION_DOWN
04-11 09:50:21.176: DEBUG/LayoutView1(301): onInterceptTouchEvent action:ACTION_MOVE
04-11 09:50:21.176: DEBUG/LayoutView2(301): onTouchEvent action:ACTION_MOVE
04-11 09:50:21.206: DEBUG/LayoutView1(301): onInterceptTouchEvent action:ACTION_MOVE
04-11 09:50:21.217: DEBUG/LayoutView2(301): onTouchEvent action:ACTION_MOVE
…… // 省略过多的 ACTION_MOVE
04-11 09:50:21.486: DEBUG/LayoutView1(301): onInterceptTouchEvent action:ACTION_UP
04-11 09:50:21.486: DEBUG/LayoutView2(301): onTouchEvent action:ACTION_UP
----------------------------------------------------------------------------------------------------------------------------
可以看到,由于 MyTextView 在 onTouchEvent() 中 return false , down 事件被传递给其父 view ,即 LayoutView2 的 onTouchEvent() 方法处理,由于在 LayoutView2 的 onTouchEvent() 中 return true ,所以 down 事件传递并没有上传到 LayoutView1 。注意,后续的 move 和 up 事件均被传递给 LayoutView2 的 onTouchEvent() 处理,而没有传递给 MyTextView 。