示例
自定义一个MyCustomView
public class MyCustomView extends View {
private String TAG = "MyButton";
public MyCustomView(Context context) {
super(context);
}
public MyCustomView(Context context, AttributeSet attrs) {
super(context, attrs);
}
public MyCustomView(Context context, AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
}
@Override
public boolean dispatchTouchEvent(MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
Log.e(TAG, "dispatchTouchEvent----->>ACTION_DOWN");
break;
case MotionEvent.ACTION_MOVE:
Log.e(TAG, "dispatchTouchEvent----->>ACTION_MOVE");
break;
case MotionEvent.ACTION_UP:
Log.e(TAG, "dispatchTouchEvent----->>ACTION_UP");
break;
}
return super.dispatchTouchEvent(event);
}
@Override
public boolean onTouchEvent(MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
Log.e(TAG, "onTouchEvent----->>ACTION_DOWN");
break;
case MotionEvent.ACTION_MOVE:
Log.e(TAG, "onTouchEvent----->>ACTION_MOVE");
break;
case MotionEvent.ACTION_UP:
Log.e(TAG, "onTouchEvent----->>ACTION_UP");
break;
}
return super.onTouchEvent(event);
}
}
重写dispatchTouchEvent和onTouchEvent方法,添加三种触摸事件的打印日志。
MainActivity调用如下:
public class MainActivity extends Activity {
private MyCustomView button;
private String TAG = "MainActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
button = (MyCustomView) findViewById(R.id.button);
Log.e(TAG, "the view is clickable " + button.isClickable());
button.setClickable(true);
button.setOnTouchListener(new View.OnTouchListener() {
@Override
public boolean onTouch(View v, MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
Log.e(TAG, "onTouch------->>ACTION_DOWN");
break;
case MotionEvent.ACTION_MOVE:
Log.e(TAG, "onTouch------->>ACTION_MOVE");
break;
case MotionEvent.ACTION_UP:
Log.e(TAG, "onTouch------->>ACTION_UP");
break;
}
return false;
}
});
button.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Log.e(TAG, "onClick------->>onClick");
}
});
}
}
点击自定义MyCustomView,结果打印如下:
07-29 11:03:51.714 20278-20278/com.xjp.toucheventdemo E/MainActivity﹕ the view is clickable false
07-29 11:03:54.877 20278-20278/com.xjp.toucheventdemo E/MyButton﹕ dispatchTouchEvent----->>ACTION_DOWN
07-29 11:03:54.878 20278-20278/com.xjp.toucheventdemo E/MainActivity﹕ onTouch------->>ACTION_DOWN
07-29 11:03:54.878 20278-20278/com.xjp.toucheventdemo E/MyButton﹕ onTouchEvent----->>ACTION_DOWN
07-29 11:03:54.929 20278-20278/com.xjp.toucheventdemo E/MyButton﹕ dispatchTouchEvent----->>ACTION_MOVE
07-29 11:03:54.929 20278-20278/com.xjp.toucheventdemo E/MainActivity﹕ onTouch------->>ACTION_MOVE
07-29 11:03:54.929 20278-20278/com.xjp.toucheventdemo E/MyButton﹕ onTouchEvent----->>ACTION_MOVE
07-29 11:03:54.929 20278-20278/com.xjp.toucheventdemo E/MyButton﹕ dispatchTouchEvent----->>ACTION_UP
07-29 11:03:54.931 20278-20278/com.xjp.toucheventdemo E/MainActivity﹕ onTouch------->>ACTION_UP
07-29 11:03:54.931 20278-20278/com.xjp.toucheventdemo E/MyButton﹕ onTouchEvent----->>ACTION_UP
07-29 11:03:54.936 20278-20278/com.xjp.toucheventdemo E/MainActivity﹕ onClick------->>onClick
分析:有上面的打印可以看出
- 触摸事件主要有三种且执行顺序为:ACTION_DOWN,ACTION_MOVE,ACTION_UP。也就是先执行ACTION_DOWN按下的行为,按下之后手指可能会移动,移动时就出发了ACTION_MOVE行为,当手指抬起时,触发了ACTION_UP行为,至此触摸事件顺序执行结束。当然触摸事件不止这三种行为,但是我们这里主要分析这三种。
- 触摸事件过程执行的方法顺序为:dispatchTouchEvent,onTouch,onTouchEvent。最后执行了onClick点击事件。也就是顺序应该为:dispatchTouchEvent–>>onTouch–>>onTouchEvent–>>onClick
- onClick点击事件是在触摸事件ACTION_UP执行完之后才执行。
为什么会有以上三种现象和情况出现?现在我们只能从打印日志中看到结果,但是并不知道其内部原因,为了窥探其内部原因,read the fuck code 。基于Android2.0源码分析View。View的触摸事件分发是从View#dispatchTouchEvent方法开始执行的。至于为什么从这里,以后再说。
View#dispatchTouchEvent触摸事件分发
public boolean dispatchTouchEvent(MotionEvent event) {
if (mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED &&
mOnTouchListener.onTouch(this, event)) {
return true;
}
return onTouchEvent(event);
}
分析:方法实现很简单,当满足if条件就返回true退出方法,条件不满足时,才去执行onTouchEvent方法且返回该方法的返回值。
1.那么什么情况下满足mOnTouchListener != null条件呢?查看View源码发现调用如下方法时:
public void setOnTouchListener(OnTouchListener l) {
mOnTouchListener = l;
}
当开发者给相应的View设置了View#setOnTouchListener触摸事件之后,mOnTouchListener != null条件就成立。
2.View默认都是enabled状态,所以第二个条件成立。
3.当前两个条件都成立了,执行第三个条件接口方法mOnTouchListener.onTouch(this, event)。根据该方法的返回值来决定if条件是否成立。该方法在开发者设置View#setOnTouchListener触摸事件实现,当onTouch方法返回false时,dispatchTouchEvent方法就会执行onTouchEvent方法,否则不执行onTouchEvent方法。
总结:
1.onTouch接口方法的返回值决定是否执行onTouchEvent方法。
2.只要onTouch接口方法返回值为true,dispatchTouchEvent方法一定返回true,否则根据onTouchEvent方法返回值决定dispatchTouchEvent返回值。
View#onTouchEvent
进入onTouchEvent方法:
public boolean onTouchEvent(MotionEvent event) {
final int viewFlags = mViewFlags;
................
if (((viewFlags & CLICKABLE) == CLICKABLE ||
(viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)) {
switch (event.getAction()) {
case MotionEvent.ACTION_UP:
if ((mPrivateFlags & PRESSED) != 0) {
// take focus if we don't have it already and we should in
// touch mode.
boolean focusTaken = false;
if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
focusTaken = requestFocus();
}
if (!mHasPerformedLongPress) {
// This is a tap, so remove the longpress check
if (mPendingCheckForLongPress != null) {
removeCallbacks(mPendingCheckForLongPress);
}
// Only perform take click actions if we were in the pressed state
if (!focusTaken) {
performClick();
}
}
if (mUnsetPressedState == null) {
mUnsetPressedState = new UnsetPressedState();
}
if (!post(mUnsetPressedState)) {
// If the post failed, unpress right now
mUnsetPressedState.run();
}
}
break;
case MotionEvent.ACTION_DOWN:
mPrivateFlags |= PRESSED;
refreshDrawableState();
if ((mViewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) {
postCheckForLongClick();
}
break;
case MotionEvent.ACTION_CANCEL:
mPrivateFlags &= ~PRESSED;
refreshDrawableState();
break;
case MotionEvent.ACTION_MOVE:
final int x = (int) event.getX();
final int y = (int) event.getY();
// Be lenient about moving outside of buttons
int slop = ViewConfiguration.get(mContext).getScaledTouchSlop();
if ((x < 0 - slop) || (x >= getWidth() + slop) ||
(y < 0 - slop) || (y >= getHeight() + slop)) {
// Outside button
if ((mPrivateFlags & PRESSED) != 0) {
// Remove any future long press checks
if (mPendingCheckForLongPress != null) {
removeCallbacks(mPendingCheckForLongPress);
}
// Need to switch from pressed to not pressed
mPrivateFlags &= ~PRESSED;
refreshDrawableState();
}
} else {
// Inside button
if ((mPrivateFlags & PRESSED) == 0) {
// Need to switch from not pressed to pressed
mPrivateFlags |= PRESSED;
refreshDrawableState();
}
}
break;
}
return true;
}
return false;
}
分析:代码有点长,首先进入该方法判断if条件是否成立?如果该View是可点击的或者是可以长按点击,则if条件成立,进入if判断,执行ACTION_UP分支。
1.代码第26行,调用了performClick方法来执行View的点击事件
public boolean performClick() {
sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);
if (mOnClickListener != null) {
playSoundEffect(SoundEffectConstants.CLICK);
mOnClickListener.onClick(this);
return true;
}
return false;
}
该方法判断如果mOnClickListener!=null条件成立,则执行mOnClickListener.onClick(this);接口方法。什么时候条件成立呢?当给当前View设置了点击监听事件之后,条件成立,因此调用接口onClick方法。在View类中有如下方法:
public void setOnClickListener(OnClickListener l) {
if (!isClickable()) {
setClickable(true);
}
mOnClickListener = l;
}
先判断当前View是否可点击的状态?如果不可点击的话,先设置成可点击,之后对mOnClickListener赋值操作。总结:只要给任何一个View设置了setOnClickListener点击监听事件,不管这个View是否是可点击的状态,最后都设置为了可点击的状态了。
2.只有当前View是可点击或者长按的状态,才进入if条件判断,然后执行相应的手势操作,最后返回true。也就是说,只要View是可点击的,onTouchEvent方法返回的就是true,从而dispatchTouchEvent方法返回的也是true。
3.只要是当前View是不可点击或者长按的状态,if条件不成立,不执行任何操作,直接返回false。也就是说,View不可点击的时候,onTouchEvent方法返回的就是false,从而dispatchTouchEvent方法返回的也是false。
4.onClick方法是在ACTION_UP手势里面执行的,也就是当手势抬起时才去执行onClick方法。
到此,Android View触摸事件传递已经分析结束。如果条件都满足,则整个触摸事件传递过程就是:dispatchTouchEvent–>>onTouch–>>onTouchEvent–>>onClick。现在我们来验证一下如下几种情况:
onTouch方法返回值为true
改成如下
button.setOnTouchListener(new View.OnTouchListener() {
@Override
public boolean onTouch(View v, MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
Log.e(TAG, "onTouch------->>ACTION_DOWN");
break;
case MotionEvent.ACTION_MOVE:
Log.e(TAG, "onTouch------->>ACTION_MOVE");
break;
case MotionEvent.ACTION_UP:
Log.e(TAG, "onTouch------->>ACTION_UP");
break;
}
return true;
}
});
此时点击View的打印如下:
07-29 14:42:22.969 2964-2964/com.xjp.toucheventdemo E/MyButton﹕ dispatchTouchEvent----->>ACTION_DOWN
07-29 14:42:22.970 2964-2964/com.xjp.toucheventdemo E/MainActivity﹕ onTouch------->>ACTION_DOWN
07-29 14:42:22.987 2964-2964/com.xjp.toucheventdemo E/MyButton﹕ dispatchTouchEvent----->>ACTION_MOVE
07-29 14:42:22.987 2964-2964/com.xjp.toucheventdemo E/MainActivity﹕ onTouch------->>ACTION_MOVE
07-29 14:42:22.987 2964-2964/com.xjp.toucheventdemo E/MyButton﹕ dispatchTouchEvent----->>ACTION_UP
07-29 14:42:22.988 2964-2964/com.xjp.toucheventdemo E/MainActivity﹕ onTouch------->>ACTION_UP
当onTouch方法返回true时,就不执行onTouchEvnet方法,因此也就不执行onClick点击事件。可以理解成此时onTouch把触摸事件已经消费掉了,也就不会继续往下传递触摸事件。所以如果你不想自己的View执行onTouchEvent方法,你可以设置onTouch事件,且返回值为true即可。
View不可点击情况
在文章开头的 MainActivity里面,我是添加了一行代码 button.setClickable(true); 目的是让当前View可点击,但是默认情况下除了Button,TextView少数控件外,其他大部分View控件默认都是不可点击的状态,除非你设置了View#setClickable(true)或者View#setOnClickListener。现在我将MainActivity中的button.setClickable(true);这一行代码去掉且不设置setOnClickListener事件
public class MainActivity extends Activity {
private MyCustomView button;
private String TAG = "MainActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
button = (MyCustomView) findViewById(R.id.button);
Log.e(TAG, "the view is clickable " + button.isClickable());
// button.setClickable(true);
button.setOnTouchListener(new View.OnTouchListener() {
@Override
public boolean onTouch(View v, MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
Log.e(TAG, "onTouch------->>ACTION_DOWN");
break;
case MotionEvent.ACTION_MOVE:
Log.e(TAG, "onTouch------->>ACTION_MOVE");
break;
case MotionEvent.ACTION_UP:
Log.e(TAG, "onTouch------->>ACTION_UP");
break;
}
return false;
}
});
// button.setOnClickListener(new View.OnClickListener() {
// @Override
// public void onClick(View v) {
// Log.e(TAG, "onClick------->>onClick");
// }
// });
}
}
Log打印日志如下:
07-29 14:57:03.656 4896-4896/com.xjp.toucheventdemo E/MyButton﹕ dispatchTouchEvent----->>ACTION_DOWN
07-29 14:57:03.658 4896-4896/com.xjp.toucheventdemo E/MainActivity﹕ onTouch------->>ACTION_DOWN
07-29 14:57:03.658 4896-4896/com.xjp.toucheventdemo E/MyButton﹕ onTouchEvent----->>ACTION_DOWN
不知道你发现木有?此处打印看出只执行了ACTION_DOWN手指操作,其他的手势操作呢?没有执行,为什么呢?
情况是这样的:当onTouch方法返回false,则dispatchTouchEvent方法就会执行onTouchEvent方法,但是由于View不可点击,所以onTouchEvent是不执行if条件体的,也就是onTouchEvent方法返回false,从而导致dispatchTouchEvent方法返回false,由于dispatchTouchEvent方法返回false,导致后面的手势操作ACTION_MOVE,ACTION_UP得不到执行。
总结:如果我们将手势操作分为三个过程的话:ACTION_DOWN,ACTION_MOVE,ACTION_UP。只有当dispatchTouchEvent方法返回true时,系统才会执行对应过程后面的手势操作。
总结
至此Android View 触摸事件传递机制已经分析结束,现在用一个流程图来体现:
- 触摸事件传递顺序:dispatchTouchEvent–>>onTouch–>>onTouchEvent–>>onClick。
- onTouch和onTouchEvent区别:两个方法先后在dispatchTouchEvent中调用,只有给View设置了触摸事件View#setOnTouchListener才会执行onTouch方法;onTouch方法的返回值决定是否执行onTouchEvent方法。
- 手势操作执行的顺序为ACTION_DOWN,ACTION_MOVE,ACTION_UP,只有dispatchTouchEvent方法返回true值时后面的手势才会被执行。
- onClick方法的调用是在onTouchEvent的ACTION_UP手势里面执行的,也就是当手势抬起时,手势操作结束才会触发onClick方法的调用。