我们都知道,每个触摸事件都代表用户在屏幕上的一个动作,而每个动作必定有其发生的位置。在MotionEvent
中就有一系列与标触摸事件发生位置相关的函数:
getX()
和getY()
:由这两个函数获得的x,y值是相对的坐标值,相对于消费这个事件的视图的左上点的坐标。getRawX()
和getRawY()
:有这两个函数获得的x,y值是绝对坐标,是相对于屏幕的。ViewGroup
的dispatchTransformedTouchEvent
函数有如下一段代码:
1 2 3 4 5 |
final float offsetX = mScrollX - child.mLeft; final float offsetY = mScrollY - child.mTop; event.offsetLocation(offsetX, offsetY); handled = child.dispatchTouchEvent(event); event.offsetLocation(-offsetX, -offsetY); |
这段代码清晰展示了父视图把事件分发给子视图时,getX()
和getY
所获得的相关坐标是如何改变的。当父视图处理事件时,上述两个函数获得的相对坐标是相对于父视图的,然后通过上边这段代码,调整了相对坐标的值,让其变为相对于子视图啦。
涉及MotionEvent
使用的代码一般如下:
1 2 3 4 5 6 7 8 9 |
int action = MotionEventCompat.getActionMasked(event); switch(action) { case MotionEvent.ACTION_DOWN: break; case MotionEvent.ACTION_MOVE: break; case MotionEvent.ACTION_UP: break; } |
这里就引入了关于MotionEvent
的一个重要概念,事件类型。事件类型就是指MotionEvent
对象所代表的动作。比如说,当你的一个手指在屏幕上滑动一下时,系统会产生一系列的触摸事件对象,他们所代表的动作有所不同。有的事件代表你手指按下这个动作,有的事件代表你手指在屏幕上滑动,还有的事件代表你手指离开屏幕。这些事件的事件类型就分别为ACTION_DOWN
,ACTION_MOVE
,和ACTION_UP
。上述这个动作所产生的一系列事件,被称为一个事件流,它包括一个ACTION_DOWN
事件,很多个ACTION_MOVE
事件,和一个ACTION_UP
事件。
当然,除了这三个类型外,还有很多不同的事件类型,比如ACTION_CANCEL
。它代表当前的手势被取消。要理解这个类型,就必须要了解ViewGroup
分发事件的机制。一般来说,如果一个子视图接收了父视图分发给它的ACTION_DOWN
事件,那么与ACTION_DOWN
事件相关的事件流就都要分发给这个子视图,但是如果父视图希望拦截其中的一些事件,不再继续转发事件给这个子视图的话,那么就需要给子视图一个ACTION_CANCEL
事件。
其他的类型会在接下来的博文中一一解释。
细心的同学会发现,在上一节我描述用户手指在屏幕上滑动的例子时,特地说明了手指的数量为一个。那么当用户两个或者多个手指在屏幕上滑动时,系统又会产生怎样的事件流呢?
为了可以表示多个触摸点的动作,MotionEvent
中引入了Pointer
的概念,一个pointer就代表一个触摸点,每个pointer都有自己的事件类型,也有自己的横轴坐标值。一个MotionEvent
对象中可能会存储多个pointer的相关信息,每个pointer都会有一个自己的id和index。pointer的id在整个事件流中是不会发生变化的,但是index会发生变化。
MotionEvent
类中的很多方法都是可以传入一个int值作为参数的,其实传入的就是pointer的index值。比如getX(pointerIndex)
和getY(pointerIndex)
,此时,它们返回的就是index所代表的触摸点相关事件坐标值。
由于pointer的index值在不同的MotionEvent
对象中会发生变化,但是id值却不会变化。所以,当我们要记录一个触摸点的事件流时,就只需要保存其id,然后使用findPointerIndex(int)
来获得其index值,然后再获得其他信息。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
private final static int INVALID_ID = -1; private int mActivePointerId = INVALID_ID; private int mSecondaryPointerId = INVALID_ID; private float mPrimaryLastX = -1; private float mPrimaryLastY = -1; private float mSecondaryLastX = -1; private float mSecondaryLastY = -1; public boolean onTouchEvent(MotionEvent event) { int action = MotionEventCompat.getActionMasked(event); switch (action) { case MotionEvent.ACTION_DOWN: int index = event.getActionIndex(); mActivePointerId = event.getPointerId(index); mPrimaryLastX = MotionEventCompat.getX(event,index); mPrimaryLastY = MotionEventCompat.getY(event,index); break; case MotionEvent.ACTION_POINTER_DOWN: index = event.getActionIndex(); mSecondaryPointerId = event.getPointerId(index); mSecondaryLastX = event.getX(index); mSecondaryLastY = event.getY(index); break; case MotionEvent.ACTION_MOVE: index = event.findPointerIndex(mActivePointerId); int secondaryIndex = MotionEventCompat.findPointerIndex(event,mSecondaryPointerId); final float x = MotionEventCompat.getX(event,index); final float y = MotionEventCompat.getY(event,index); final float secondX = MotionEventCompat.getX(event,secondaryIndex); final float secondY = MotionEventCompat.getY(event,secondaryIndex); break; case MotionEvent.ACTION_POINTER_UP: xxxxxx(涉及pointer id的转换,之后的文章会讲解) break; case MotionEvent.ACTION_UP: case MotionEvent.ACTION_CANCEL: mActivePointerId = INVALID_ID; mPrimaryLastX =-1; mPrimaryLastY = -1; break; } return true; } |
除了pointer的概念,MotionEvent
还引入了两个事件类型:
ACTION_POINTER_DOWN
:代表用户又使用一个手指触摸到屏幕上,也就是说,在已经有一个触摸点的情况下,有新出现了一个触摸点。ACTION_POINTER_UP
:代表用户的一个手指离开了触摸屏,但是还有其他手指还在触摸屏上。也就是说,在多个触摸点存在的情况下,其中一个触摸点消失了。它与ACTION_UP
的区别就是,它是在多个触摸点中的一个触摸点消失时(此时,还有触摸点存在,也就是说用户还有手指触摸屏幕)产生,而ACTION_UP
可以说是最后一个触摸点消失时产生。 那么,用户先两个手指先后接触屏幕,同时滑动,然后在先后离开这一套动作所产生的事件流是什么样的呢?
它所产生的事件流如下:
ACTION_DOWN
事件,代表用户的第一个手指接触到了屏幕。ACTION_POINTER_DOWN
事件,代表用户的第二个手指接触到了屏幕。ACTION_MOVE
事件,但是在这些MotionEvent
对象中,都保存着两个触摸点滑动的信息,相关的代码我们会在文章的最后进行演示。ACTION_POINTER_UP
事件,代表用户的一个手指离开了屏幕。ACTION_MOVE
事件。ACTION_UP
事件,代表用户的最后一个手指离开了屏幕
这一段之前有问题,多谢马同学指出其中的错误。
看到文章开头那段代码的同学可能会有点疑问:好像在很多代码里,大家都是通过getAction
获得事件类型的,那么它和getActionMasked
又有什么不同呢?
从上一节我们可以得知,一个MotionEvent
对象中可以包含多个触摸点的事件。当MotionEvent
对象只包含一个触摸点的事件时,上边两个函数的结果是相同的,但是当包含多个触摸点时,二者的结果就不同啦。
getAction
获得的int值是由pointer的index值和事件类型值组合而成的,而getActionWithMasked
则只返回事件的类型值
举个例子(注:假设了int中不同位所代表的含义,可能不是例子所中的前8位代表index,后8位代表事件类型):
1 2 3 |
getAction() returns 0x0105. getActionMasked() will return 0x0005 其中0x0100就是pointer的index值。 |
一般来说,(getAction() & ACTION_POINTER_INDEX_MASK)>>ACTION_POINTER_INDEX_SHIFT
就获得了pointer的index,等同于getActionIndex
函数;getAction()& ACTION_MASK
就获得了pointer的事件类型,等同于getActionMasked
函数。
为了效率,Android系统在处理ACTION_MOVE
事件时会将连续的几个多触点移动事件打包到一个MotionEvent
对象中。我们可以通过getX(int)
和getY(int)
来获得最近发生的一个触摸点事件的坐标,然后使用getHistorical(int,int)
和getHistorical(int,int)
来获得时间稍早的触点事件的坐标,二者是发生时间先后的关系。所以,我们应该先处理通过getHistoricalXX
相关函数获得的事件信息,然后在处理当前的事件信息。
下边就是Android Guide中相关的例子:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
void printSamples(MotionEvent ev) { final int historySize = ev.getHistorySize(); final int pointerCount = ev.getPointerCount(); for (int h = 0; h < historySize; h++) { System.out.printf("At time %d:", ev.getHistoricalEventTime(h)); for (int p = 0; p < pointerCount; p++) { System.out.printf(" pointer %d: (%f,%f)", ev.getPointerId(p), ev.getHistoricalX(p, h), ev.getHistoricalY(p, h)); } } System.out.printf("At time %d:", ev.getEventTime()); for (int p = 0; p < pointerCount; p++) { System.out.printf(" pointer %d: (%f,%f)", ev.getPointerId(p), ev.getX(p), ev.getY(p)); } } |