Android 事件分发事件分发源码分析 ( ViewGroup 事件传递机制 一 )

Posted 2021-07-06 韩曙亮

android 事件分发 系列文章目录

【Android 事件分发】事件分发源码分析 ( 驱动层通过中断传递事件 | WindowManagerService 向 View 层传递事件 )
【Android 事件分发】事件分发源码分析 ( Activity 中各层级的事件传递 | Activity -＞ PhoneWindow -＞ DecorView -＞ ViewGroup )
【Android 事件分发】事件分发源码分析 ( ViewGroup 事件传递机制 一 )

---

文章目录

• 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) != 0;

调用 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;
    }
}

源码路径 : /frameworks/base/core/java/android/view/ViewGroup.java