文章目录
Android 事件分发 系列文章目录
前言
一、无障碍调用
二、判定是否首次按下
三、判定是否拦截
四、判定是否取消操作
五、ViewGroup 事件分发相关源码
前言
在上一篇博客 【Android 事件分发】事件分发源码分析 ( Activity 中各层级的事件传递 | Activity -> PhoneWindow -> DecorView -> ViewGroup ) 分析到 , 触摸事件从 驱动层 -> Framework -> WMS -> Activity , 在 Activity 内部又按照 Activity -> PhoneWindow -> DecorView -> ViewGroup , 最终传递到 ViewGroup 中 ;
最终传递到 ViewGroup 中的 dispatchTouchEvent 方法 , 这是触摸事件分发的关键方法 ;
一、无障碍调用
无障碍 辅助功能 是为了帮助残障人士使用的 跨进程调用 ;
ViewGroup | dispatchTouchEvent 方法中 , 先进行了 无障碍 辅助功能 的判定 , 判断当前是否正在使用 无障碍 相关功能产生事件
判断产生事件的目标组件是可访问性的 , 那么按照普通的事件分发进行处理 ; 可能由其子类处理点击事件 ;
ViewGroup | dispatchTouchEvent 方法相关源码 :
@UiThread public abstract class ViewGroup extends View implements ViewParent, ViewManager { @Override public boolean dispatchTouchEvent(MotionEvent ev) { // 辅助功能 , 残疾人相关辅助 , 跨进程调用 无障碍 功能 if (mInputEventConsistencyVerifier != null) { mInputEventConsistencyVerifier.onTouchEvent(ev, 1); } // If the event targets the accessibility focused view and this is it, start // normal event dispatch. Maybe a descendant is what will handle the click. // 判断产生事件的目标组件是可访问性的 , 那么按照普通的事件分发进行处理 ; // 可能由其子类处理点击事件 ; // 判断当前是否正在使用 无障碍 相关功能产生事件 if (ev.isTargetAccessibilityFocus() && isAccessibilityFocusedViewOrHost()) { ev.setTargetAccessibilityFocus(false); } } }
源码路径 : /frameworks/base/core/java/android/view/ViewGroup.java
二、判定是否首次按下
声明局部变量 , 是否按下操作 , 最终的对外返回结果 , 该 ViewGroup | dispatchTouchEvent 方法的最终返回值 ;
boolean handled = false;
如果是第一次触摸按下 , 则重置触摸状态 ;
ViewGroup | dispatchTouchEvent 方法相关源码 :
@UiThread public abstract class ViewGroup extends View implements ViewParent, ViewManager { @Override public boolean dispatchTouchEvent(MotionEvent ev) { ... // 是否按下操作 , 最终的对外返回结果 , 该方法的最终返回值 boolean handled = false; if (onFilterTouchEventForSecurity(ev)) { final int action = ev.getAction(); final int actionMasked = action & MotionEvent.ACTION_MASK; // Handle an initial down. // 判断是否是第一次按下 , 如果是第一次按下 , 则执行下面的业务逻辑 if (actionMasked == MotionEvent.ACTION_DOWN) { // Throw away all previous state when starting a new touch gesture. // The framework may have dropped the up or cancel event for the previous gesture // due to an app switch, ANR, or some other state change. cancelAndClearTouchTargets(ev); // 如果是第一次按下 , 那么重置触摸状态 resetTouchState(); } ... } }
源码路径 : /frameworks/base/core/java/android/view/ViewGroup.java
三、判定是否拦截
声明局部变量 , 表示是否拦截 , 用于多点触控按下操作的判定 ;
final boolean intercepted;
可使用 requestDisallowInterceptTouchEvent 方法判定是否允许事件拦截 ,
// 判断是否需要拦截 , 可以使用 requestDisallowInterceptTouchEvent 方法进行设置 final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) !=
调用 ViewGroup 的 requestDisallowInterceptTouchEvent 方法 , 传入 boolean disallowIntercept 参数 , 用于设置是否拦截触摸事件 ;
如果不允许事件拦截 , 则将 intercepted 设置为 false ;
如果允许事件拦截 , 调用 onInterceptTouchEvent 方法获取否进行事件拦截 , 返回一个布尔值 , 没有进行具体的事件拦截 ;
是否进行拦截 , 赋值给了 intercepted 局部变量 , 该值决定是否进行拦截传递的事件 ;
ViewGroup | dispatchTouchEvent 方法相关源码 :
@UiThread public abstract class ViewGroup extends View implements ViewParent, ViewManager { @Override public boolean dispatchTouchEvent(MotionEvent ev) { ... // Check for interception. // 判定是否拦截 // 用于多点触控按下操作的判定 final boolean intercepted; if (actionMasked == MotionEvent.ACTION_DOWN || mFirstTouchTarget != null) { // 判断是否需要拦截 , 可以使用 requestDisallowInterceptTouchEvent 方法进行设置 final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0; if (!disallowIntercept) { // 进行事件拦截 // 该 onInterceptTouchEvent 方法只返回是否进行事件拦截 , 返回一个布尔值 , 没有进行具体的事件拦截 // 是否进行拦截 , 赋值给了 intercepted 局部变量 // 该值决定是否进行拦截 intercepted = onInterceptTouchEvent(ev); ev.setAction(action); // restore action in case it was changed } else { // 不进行事件拦截 intercepted = false; } } else { // There are no touch targets and this action is not an initial down // so this view group continues to intercept touches. intercepted = true; } // If intercepted, start normal event dispatch. Also if there is already // a view that is handling the gesture, do normal event dispatch. if (intercepted || mFirstTouchTarget != null) { ev.setTargetAccessibilityFocus(false); } ... } @Override public void requestDisallowInterceptTouchEvent(boolean disallowIntercept) { // disallowIntercept 存在一个默认值 , 如果值为默认值 , 直接退出 if (disallowIntercept == ((mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0)) { // We're already in this state, assume our ancestors are too return; } // 如果不是默认值 , 则进行相应更改 // 最终的值影响 mGroupFlags 是 true 还是 false if (disallowIntercept) { mGroupFlags |= FLAG_DISALLOW_INTERCEPT; } else { mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT; } // Pass it up to our parent if (mParent != null) { mParent.requestDisallowInterceptTouchEvent(disallowIntercept); } } public boolean onInterceptTouchEvent(MotionEvent ev) { // 该方法只返回是否进行事件拦截 , 返回一个布尔值 , 没有进行具体的事件拦截 if (ev.isFromSource(InputDevice.SOURCE_MOUSE) && ev.getAction() == MotionEvent.ACTION_DOWN && ev.isButtonPressed(MotionEvent.BUTTON_PRIMARY) && isOnScrollbarThumb(ev.getX(), ev.getY())) { return true; } return false; } }
源码路径 : /frameworks/base/core/java/android/view/ViewGroup.java
四、判定是否取消操作
检查该传递的事件是否是取消事件 , MotionEvent.ACTION_CANCEL ;
取消操作就是手指移动 , 移出了组件边界 ;
该操作出现次数较少 , 一般情况默认该值是 false ;
ViewGroup | dispatchTouchEvent 方法相关源码 :
@UiThread public abstract class ViewGroup extends View implements ViewParent, ViewManager { @Override public boolean dispatchTouchEvent(MotionEvent ev) { ... // Check for cancelation. // 检查是否取消操作 , 手指是否移除了组件便捷 ; // 一般情况默认该值是 false ; final boolean canceled = resetCancelNextUpFlag(this) || actionMasked == MotionEvent.ACTION_CANCEL; // Update list of touch targets for pointer down, if needed. final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0; // 注意此处 newTouchTarget 为空 TouchTarget newTouchTarget = null; boolean alreadyDispatchedToNewTouchTarget = false; ... } }
源码路径 : /frameworks/base/core/java/android/view/ViewGroup.java
五、ViewGroup 事件分发相关源码
ViewGroup 事件分发相关源码 : 下面的代码中 , 逐行注释分析了 ViewGroup 的 dispatchTouchEvent 事件分发操作 ;
@UiThread public abstract class ViewGroup extends View implements ViewParent, ViewManager { // First touch target in the linked list of touch targets. private TouchTarget mFirstTouchTarget; @Override public boolean dispatchTouchEvent(MotionEvent ev) { // 辅助功能 , 残疾人相关辅助 , 跨进程调用 无障碍 功能 if (mInputEventConsistencyVerifier != null) { mInputEventConsistencyVerifier.onTouchEvent(ev, 1); } // If the event targets the accessibility focused view and this is it, start // normal event dispatch. Maybe a descendant is what will handle the click. // 判断产生事件的目标组件是可访问性的 , 那么按照普通的事件分发进行处理 ; // 可能由其子类处理点击事件 ; // 判断当前是否正在使用 无障碍 相关功能产生事件 if (ev.isTargetAccessibilityFocus() && isAccessibilityFocusedViewOrHost()) { ev.setTargetAccessibilityFocus(false); } // 是否按下操作 , 最终的对外返回结果 , 该方法的最终返回值 boolean handled = false; if (onFilterTouchEventForSecurity(ev)) { final int action = ev.getAction(); final int actionMasked = action & MotionEvent.ACTION_MASK; // Handle an initial down. // 判断是否是第一次按下 , 如果是第一次按下 , 则执行下面的业务逻辑 if (actionMasked == MotionEvent.ACTION_DOWN) { // Throw away all previous state when starting a new touch gesture. // The framework may have dropped the up or cancel event for the previous gesture // due to an app switch, ANR, or some other state change. cancelAndClearTouchTargets(ev); // 如果是第一次按下 , 那么重置触摸状态 resetTouchState(); } // Check for interception. // 判定是否拦截 // 用于多点触控按下操作的判定 final boolean intercepted; if (actionMasked == MotionEvent.ACTION_DOWN || mFirstTouchTarget != null) { // 判断是否需要拦截 , 可以使用 requestDisallowInterceptTouchEvent 方法进行设置 final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0; if (!disallowIntercept) { // 进行事件拦截 // 该 onInterceptTouchEvent 方法只返回是否进行事件拦截 , 返回一个布尔值 , 没有进行具体的事件拦截 // 是否进行拦截 , 赋值给了 intercepted 局部变量 // 该值决定是否进行拦截 intercepted = onInterceptTouchEvent(ev); ev.setAction(action); // restore action in case it was changed } else { // 不进行事件拦截 intercepted = false; } } else { // There are no touch targets and this action is not an initial down // so this view group continues to intercept touches. intercepted = true; } // If intercepted, start normal event dispatch. Also if there is already // a view that is handling the gesture, do normal event dispatch. if (intercepted || mFirstTouchTarget != null) { ev.setTargetAccessibilityFocus(false); } // Check for cancelation. // 检查是否取消操作 , 手指是否移除了组件便捷 ; // 一般情况默认该值是 false ; final boolean canceled = resetCancelNextUpFlag(this) || actionMasked == MotionEvent.ACTION_CANCEL; // Update list of touch targets for pointer down, if needed. final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0; // 注意此处 newTouchTarget 为空 TouchTarget newTouchTarget = null; boolean alreadyDispatchedToNewTouchTarget = false; } @Override public void requestDisallowInterceptTouchEvent(boolean disallowIntercept) { // disallowIntercept 存在一个默认值 , 如果值为默认值 , 直接退出 if (disallowIntercept == ((mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0)) { // We're already in this state, assume our ancestors are too return; } // 如果不是默认值 , 则进行相应更改 // 最终的值影响 mGroupFlags 是 true 还是 false if (disallowIntercept) { mGroupFlags |= FLAG_DISALLOW_INTERCEPT; } else { mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT; } // Pass it up to our parent if (mParent != null) { mParent.requestDisallowInterceptTouchEvent(disallowIntercept); } } public boolean onInterceptTouchEvent(MotionEvent ev) { // 该方法只返回是否进行事件拦截 , 返回一个布尔值 , 没有进行具体的事件拦截 if (ev.isFromSource(InputDevice.SOURCE_MOUSE) && ev.getAction() == MotionEvent.ACTION_DOWN && ev.isButtonPressed(MotionEvent.BUTTON_PRIMARY) && isOnScrollbarThumb(ev.getX(), ev.getY())) { return true; } return false; } }