/**
  * 源碼分析：Activity.dispatchTouchEvent（）
  */ 
    public boolean dispatchTouchEvent(MotionEvent ev) {
    
            if (ev.getAction() == MotionEvent.ACTION_DOWN) {
                onUserInteraction();
            }

            if (getWindow().superDispatchTouchEvent(ev)) {

                return true;
                // 若getWindow().superDispatchTouchEvent(ev)的返回true
                // 則Activity.dispatchTouchEvent（）就返回true，則方法結(jié)束。即 ：該點(diǎn)擊事件停止往下傳遞 & 事件傳遞過(guò)程結(jié)束
                // 否則：繼續(xù)往下調(diào)用Activity.onTouchEvent

            }
            return onTouchEvent(ev);
        }

/**
  * getWindow().superDispatchTouchEvent(ev)
  * 說(shuō)明：
  *     a. getWindow() = 獲取Window類的對(duì)象
  *     b. Window類是抽象類，其唯一實(shí)現(xiàn)類 = PhoneWindow類；即此處的Window類對(duì)象 = PhoneWindow類對(duì)象
  *     c. Window類的superDispatchTouchEvent() = 1個(gè)抽象方法，由子類PhoneWindow類實(shí)現(xiàn)
  */
    @Override
    public boolean superDispatchTouchEvent(MotionEvent event) {

        return mDecor.superDispatchTouchEvent(event);
        // mDecor = 頂層View（DecorView）的實(shí)例對(duì)象
    }

/**
  * mDecor.superDispatchTouchEvent(event)
  * 定義：屬于頂層View（DecorView）
  * 說(shuō)明：
  *     a. DecorView類是PhoneWindow類的一個(gè)內(nèi)部類
  *     b. DecorView繼承自FrameLayout，是所有界面的父類
  *     c. FrameLayout是ViewGroup的子類，故DecorView的間接父類 = ViewGroup
  */
    public boolean superDispatchTouchEvent(MotionEvent event) {

        return super.dispatchTouchEvent(event);
        // 調(diào)用父類的方法 = ViewGroup的dispatchTouchEvent()
        // 即 將事件傳遞到ViewGroup去處理，詳細(xì)請(qǐng)看ViewGroup的事件分發(fā)機(jī)制

    }

/**
  * Activity.onTouchEvent（）
  * 定義：屬于頂層View（DecorView）
  * 說(shuō)明：
  *     a. DecorView類是PhoneWindow類的一個(gè)內(nèi)部類
  *     b. DecorView繼承自FrameLayout，是所有界面的父類
  *     c. FrameLayout是ViewGroup的子類，故DecorView的間接父類 = ViewGroup
  */
  public boolean onTouchEvent(MotionEvent event) {

        // 當(dāng)一個(gè)點(diǎn)擊事件未被Activity下任何一個(gè)View接收 / 處理時(shí)
        // 應(yīng)用場(chǎng)景：處理發(fā)生在Window邊界外的觸摸事件
        if (mWindow.shouldCloseOnTouch(this, event)) {
            finish();
            return true;
        }
        
        return false;
        // 即只有在點(diǎn)擊事件在Window邊界外才會(huì)返回true，一般情況都返回false
    }

/**
  * 源碼分析：ViewGroup.dispatchTouchEvent（）
  */ 
    public boolean dispatchTouchEvent(MotionEvent ev) { 

    ... // 僅貼出關(guān)鍵代碼

        // ViewGroup每次事件分發(fā)時(shí)，都需調(diào)用onInterceptTouchEvent()詢問(wèn)是否攔截事件
            if (disallowIntercept || !onInterceptTouchEvent(ev)) {  

            // 判斷值1：disallowIntercept = 是否禁用事件攔截的功能(默認(rèn)是false)，可通過(guò)調(diào)用requestDisallowInterceptTouchEvent（）修改
            // 判斷值2： !onInterceptTouchEvent(ev) = 對(duì)onInterceptTouchEvent()返回值取反
                    // a. 若在onInterceptTouchEvent()中返回false（即不攔截事件），就會(huì)讓第二個(gè)值為true，從而進(jìn)入到條件判斷的內(nèi)部
                    // b. 若在onInterceptTouchEvent()中返回true（即攔截事件），就會(huì)讓第二個(gè)值為false，從而跳出了這個(gè)條件判斷
                    // c. 關(guān)于onInterceptTouchEvent() ->>分析1

                ev.setAction(MotionEvent.ACTION_DOWN);  
                final int scrolledXInt = (int) scrolledXFloat;  
                final int scrolledYInt = (int) scrolledYFloat;  
                final View[] children = mChildren;  
                final int count = mChildrenCount;  

            // 通過(guò)for循環(huán)，遍歷了當(dāng)前ViewGroup下的所有子View
            for (int i = count - 1; i >= 0; i--) {  
                final View child = children[i];  
                if ((child.mViewFlags & VISIBILITY_MASK) == VISIBLE  
                        || child.getAnimation() != null) {  
                    child.getHitRect(frame);  

                    // 判斷當(dāng)前遍歷的View是不是正在點(diǎn)擊的View，從而找到當(dāng)前被點(diǎn)擊的View
                    // 若是，則進(jìn)入條件判斷內(nèi)部
                    if (frame.contains(scrolledXInt, scrolledYInt)) {  
                        final float xc = scrolledXFloat - child.mLeft;  
                        final float yc = scrolledYFloat - child.mTop;  
                        ev.setLocation(xc, yc);  
                        child.mPrivateFlags &= ~CANCEL_NEXT_UP_EVENT;  

                        // 條件判斷的內(nèi)部調(diào)用了該View的dispatchTouchEvent()
                        // 即 實(shí)現(xiàn)了點(diǎn)擊事件從ViewGroup到子View的傳遞（具體請(qǐng)看下面的View事件分發(fā)機(jī)制）
                        if (child.dispatchTouchEvent(ev))  { 

                        mMotionTarget = child;  
                        return true; 
                        // 調(diào)用子View的dispatchTouchEvent后是有返回值的
                        // 若該控件可點(diǎn)擊，那么點(diǎn)擊時(shí)，dispatchTouchEvent的返回值必定是true，因此會(huì)導(dǎo)致條件判斷成立
                        // 于是給ViewGroup的dispatchTouchEvent（）直接返回了true，即直接跳出
                        // 即把ViewGroup的點(diǎn)擊事件攔截掉

                                }  
                            }  
                        }  
                    }  
                }  
            }  
            boolean isUpOrCancel = (action == MotionEvent.ACTION_UP) ||  
                    (action == MotionEvent.ACTION_CANCEL);  
            if (isUpOrCancel) {  
                mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT;  
            }  
            final View target = mMotionTarget;  

      
        // 若點(diǎn)擊的是空白處（即無(wú)任何View接收事件） / 攔截事件（手動(dòng)復(fù)寫onInterceptTouchEvent（），從而讓其返回true）
        if (target == null) {  
            ev.setLocation(xf, yf);  
            if ((mPrivateFlags & CANCEL_NEXT_UP_EVENT) != 0) {  
                ev.setAction(MotionEvent.ACTION_CANCEL);  
                mPrivateFlags &= ~CANCEL_NEXT_UP_EVENT;  
            }  
            
            return super.dispatchTouchEvent(ev);
            // 調(diào)用ViewGroup父類的dispatchTouchEvent()，即View.dispatchTouchEvent()
            // 因此會(huì)執(zhí)行ViewGroup的onTouch() ->> onTouchEvent() ->> performClick（） ->> onClick()，即自己處理該事件，事件不會(huì)往下傳遞（具體請(qǐng)參考View事件的分發(fā)機(jī)制中的View.dispatchTouchEvent（））
            // 此處需與上面區(qū)別：子View的dispatchTouchEvent（）
        } 

        ... 

}
/**
  * ViewGroup.onInterceptTouchEvent()
  * 作用：是否攔截事件
  * 說(shuō)明：
  *     a. 返回true = 攔截，即事件停止往下傳遞（需手動(dòng)設(shè)置，即復(fù)寫onInterceptTouchEvent（），從而讓其返回true）
  *     b. 返回false = 不攔截（默認(rèn)）
  */
  public boolean onInterceptTouchEvent(MotionEvent ev) {  
    
    return false;

  } 

/**
  * 源碼分析：View.dispatchTouchEvent（）
  */
  public boolean dispatchTouchEvent(MotionEvent event) {  

        if (mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED &&  
                mOnTouchListener.onTouch(this, event)) {  
            return true;  
        } 
        return onTouchEvent(event);  
  }
  // 說(shuō)明：只有以下3個(gè)條件都為真，dispatchTouchEvent()才返回true；否則執(zhí)行onTouchEvent()
  //     1. mOnTouchListener != null
  //     2. (mViewFlags & ENABLED_MASK) == ENABLED
  //     3. mOnTouchListener.onTouch(this, event)
  // 下面對(duì)這3個(gè)條件逐個(gè)分析


/**
  * 條件1：mOnTouchListener != null
  * 說(shuō)明：mOnTouchListener變量在View.setOnTouchListener（）方法里賦值
  */
  public void setOnTouchListener(OnTouchListener l) { 

    mOnTouchListener = l;  
    // 即只要我們給控件注冊(cè)了Touch事件，mOnTouchListener就一定被賦值（不為空）
        
} 

/**
  * 條件2：(mViewFlags & ENABLED_MASK) == ENABLED
  * 說(shuō)明：
  *     a. 該條件是判斷當(dāng)前點(diǎn)擊的控件是否enable
  *     b. 由于很多View默認(rèn)enable，故該條件恒定為true
  */

/**
  * 條件3：mOnTouchListener.onTouch(this, event)
  * 說(shuō)明：即 回調(diào)控件注冊(cè)Touch事件時(shí)的onTouch（）；需手動(dòng)復(fù)寫設(shè)置，具體如下（以按鈕Button為例）
  */
    button.setOnTouchListener(new OnTouchListener() {  
        @Override  
        public boolean onTouch(View v, MotionEvent event) {  
     
            return false;  
        }  
    });
    // 若在onTouch（）返回true，就會(huì)讓上述三個(gè)條件全部成立，從而使得View.dispatchTouchEvent（）直接返回true，事件分發(fā)結(jié)束
    // 若在onTouch（）返回false，就會(huì)使得上述三個(gè)條件不全部成立，從而使得View.dispatchTouchEvent（）中跳出If，執(zhí)行onTouchEvent(event)