Android
事件分發機制是Android
開發者必須瞭解的基礎Android
事件分發機制的文章,但存在一些問題:內容不全、思路不清晰、無源碼分析、簡單問題複雜化等等 Android
的事件分發機制,我能保證這是市面上的最全面、最清晰、最易懂的
- 本文秉着「結論先行、詳細分析在後」的原則,即先讓你們感性認識,再經過理性分析從而理解問題;
- 因此,請各位讀者先記住結論,再往下繼續看分析;
答:點擊事件(Touch
事件)php
View
或 ViewGroup
派生的控件),將產生點擊事件(Touch
事件)
Touch
事件的相關細節(發生觸摸的位置、時間等)被封裝成MotionEvent
對象java
事件類型 | 具體動做 |
---|---|
MotionEvent.ACTION_DOWN | 按下View(全部事件的開始) |
MotionEvent.ACTION_UP | 擡起View(與DOWN對應) |
MotionEvent.ACTION_MOVE | 滑動View |
MotionEvent.ACTION_CANCEL | 結束事件(非人爲緣由) |
注:通常狀況下,事件列都是以
DOWN
事件開始、UP
事件結束,中間有無數的MOVE事件,以下圖:
android
即當一個點擊事件(MotionEvent
)產生後,系統需把這個事件傳遞給一個具體的 View
去處理。app
答:將點擊事件(MotionEvent)傳遞到某個具體的View
& 處理的整個過程ide
即 事件傳遞的過程 = 分發過程。函數
答:Activity、ViewGroup、View源碼分析
Android
的UI
界面由Activity
、ViewGroup
、View
及其派生類組成即 事件傳遞的順序:Activity
-> ViewGroup
-> View
佈局
即:1個點擊事件發生後,事件先傳到
Activity
、再傳到ViewGroup
、最終再傳到View
post
答:dispatchTouchEvent() 、onInterceptTouchEvent()和onTouchEvent()測試
下文會對這3個方法進行詳細介紹
Android
的事件分發有了感性的認知Android
事件分發機制Android
事件分發流程 = Activity -> ViewGroup -> View 即:1個點擊事件發生後,事件先傳到
Activity
、再傳到ViewGroup
、最終再傳到View
Activity
對點擊事件的分發機制ViewGroup
對點擊事件的分發機制View
對點擊事件的分發機制即按順序講解:
Activity
事件分發機制、ViewGroup
事件分發機制、View
事件分發機制
當一個點擊事件發生時,事件最早傳到Activity
的dispatchTouchEvent()
進行事件分發
/** * 源碼分析:Activity.dispatchTouchEvent() */ public boolean dispatchTouchEvent(MotionEvent ev) { // 通常事件列開始都是DOWN事件 = 按下事件,故此處基本是true if (ev.getAction() == MotionEvent.ACTION_DOWN) { onUserInteraction(); // ->>分析1 } // ->>分析2 if (getWindow().superDispatchTouchEvent(ev)) { return true; // 若getWindow().superDispatchTouchEvent(ev)的返回true // 則Activity.dispatchTouchEvent()就返回true,則方法結束。即 :該點擊事件中止往下傳遞 & 事件傳遞過程結束 // 不然:繼續往下調用Activity.onTouchEvent } // ->>分析4 return onTouchEvent(ev); } /** * 分析1:onUserInteraction() * 做用:實現屏保功能 * 注: * a. 該方法爲空方法 * b. 當此activity在棧頂時,觸屏點擊按home,back,menu鍵等都會觸發此方法 */ public void onUserInteraction() { } // 回到最初的調用原處 /** * 分析2:getWindow().superDispatchTouchEvent(ev) * 說明: * a. getWindow() = 獲取Window類的對象 * b. Window類是抽象類,其惟一實現類 = PhoneWindow類;即此處的Window類對象 = PhoneWindow類對象 * c. Window類的superDispatchTouchEvent() = 1個抽象方法,由子類PhoneWindow類實現 */ @Override public boolean superDispatchTouchEvent(MotionEvent event) { return mDecor.superDispatchTouchEvent(event); // mDecor = 頂層View(DecorView)的實例對象 // ->> 分析3 } /** * 分析3:mDecor.superDispatchTouchEvent(event) * 定義:屬於頂層View(DecorView) * 說明: * a. DecorView類是PhoneWindow類的一個內部類 * b. DecorView繼承自FrameLayout,是全部界面的父類 * c. FrameLayout是ViewGroup的子類,故DecorView的間接父類 = ViewGroup */ public boolean superDispatchTouchEvent(MotionEvent event) { return super.dispatchTouchEvent(event); // 調用父類的方法 = ViewGroup的dispatchTouchEvent() // 即 將事件傳遞到ViewGroup去處理,詳細請看ViewGroup的事件分發機制 } // 回到最初的調用原處 /** * 分析4:Activity.onTouchEvent() * 定義:屬於頂層View(DecorView) * 說明: * a. DecorView類是PhoneWindow類的一個內部類 * b. DecorView繼承自FrameLayout,是全部界面的父類 * c. FrameLayout是ViewGroup的子類,故DecorView的間接父類 = ViewGroup */ public boolean onTouchEvent(MotionEvent event) { // 當一個點擊事件未被Activity下任何一個View接收 / 處理時 // 應用場景:處理髮生在Window邊界外的觸摸事件 // ->> 分析5 if (mWindow.shouldCloseOnTouch(this, event)) { finish(); return true; } return false; // 即 只有在點擊事件在Window邊界外才會返回true,通常狀況都返回false,分析完畢 } /** * 分析5:mWindow.shouldCloseOnTouch(this, event) */ public boolean shouldCloseOnTouch(Context context, MotionEvent event) { // 主要是對於處理邊界外點擊事件的判斷:是不是DOWN事件,event的座標是否在邊界內等 if (mCloseOnTouchOutside && event.getAction() == MotionEvent.ACTION_DOWN && isOutOfBounds(context, event) && peekDecorView() != null) { return true; } return false; // 返回true:說明事件在邊界外,即 消費事件 // 返回false:未消費(默認) } // 回到分析4調用原處
/** * 源碼分析:Activity.dispatchTouchEvent() */ public boolean dispatchTouchEvent(MotionEvent ev) { // 通常事件列開始都是DOWN事件 = 按下事件,故此處基本是true if (ev.getAction() == MotionEvent.ACTION_DOWN) { onUserInteraction(); // ->>分析1 } // ->>分析2 if (getWindow().superDispatchTouchEvent(ev)) { return true; // 若getWindow().superDispatchTouchEvent(ev)的返回true // 則Activity.dispatchTouchEvent()就返回true,則方法結束。即 :該點擊事件中止往下傳遞 & 事件傳遞過程結束 // 不然:繼續往下調用Activity.onTouchEvent } // ->>分析4 return onTouchEvent(ev); } /** * 分析1:onUserInteraction() * 做用:實現屏保功能 * 注: * a. 該方法爲空方法 * b. 當此activity在棧頂時,觸屏點擊按home,back,menu鍵等都會觸發此方法 */ public void onUserInteraction() { } // 回到最初的調用原處 /** * 分析2:getWindow().superDispatchTouchEvent(ev) * 說明: * a. getWindow() = 獲取Window類的對象 * b. Window類是抽象類,其惟一實現類 = PhoneWindow類;即此處的Window類對象 = PhoneWindow類對象 * c. Window類的superDispatchTouchEvent() = 1個抽象方法,由子類PhoneWindow類實現 */ @Override public boolean superDispatchTouchEvent(MotionEvent event) { return mDecor.superDispatchTouchEvent(event); // mDecor = 頂層View(DecorView)的實例對象 // ->> 分析3 } /** * 分析3:mDecor.superDispatchTouchEvent(event) * 定義:屬於頂層View(DecorView) * 說明: * a. DecorView類是PhoneWindow類的一個內部類 * b. DecorView繼承自FrameLayout,是全部界面的父類 * c. FrameLayout是ViewGroup的子類,故DecorView的間接父類 = ViewGroup */ public boolean superDispatchTouchEvent(MotionEvent event) { return super.dispatchTouchEvent(event); // 調用父類的方法 = ViewGroup的dispatchTouchEvent() // 即 將事件傳遞到ViewGroup去處理,詳細請看ViewGroup的事件分發機制 } // 回到最初的調用原處 /** * 分析4:Activity.onTouchEvent() * 定義:屬於頂層View(DecorView) * 說明: * a. DecorView類是PhoneWindow類的一個內部類 * b. DecorView繼承自FrameLayout,是全部界面的父類 * c. FrameLayout是ViewGroup的子類,故DecorView的間接父類 = ViewGroup */ public boolean onTouchEvent(MotionEvent event) { // 當一個點擊事件未被Activity下任何一個View接收 / 處理時 // 應用場景:處理髮生在Window邊界外的觸摸事件 // ->> 分析5 if (mWindow.shouldCloseOnTouch(this, event)) { finish(); return true; } return false; // 即 只有在點擊事件在Window邊界外才會返回true,通常狀況都返回false,分析完畢 } /** * 分析5:mWindow.shouldCloseOnTouch(this, event) */ public boolean shouldCloseOnTouch(Context context, MotionEvent event) { // 主要是對於處理邊界外點擊事件的判斷:是不是DOWN事件,event的座標是否在邊界內等 if (mCloseOnTouchOutside && event.getAction() == MotionEvent.ACTION_DOWN && isOutOfBounds(context, event) && peekDecorView() != null) { return true; } return false; // 返回true:說明事件在邊界外,即 消費事件 // 返回false:未消費(默認) } // 回到分析4調用原處
Activity
的事件分發開始(Activity.dispatchTouchEvent()
)那麼,ViewGroup
的dispatchTouchEvent()
何時返回true
/ false
?請繼續往下看ViewGroup事件的分發機制
從上面Activity
事件分發機制可知,ViewGroup
事件分發機制從dispatchTouchEvent()
開始
Android 5.0
後,ViewGroup.dispatchTouchEvent()
的源碼發生了變化(更加複雜),但原理相同;- 本文爲了讓讀者容易理解,故採用
Android 5.0
前的版本
/** * 源碼分析:ViewGroup.dispatchTouchEvent() */ public boolean dispatchTouchEvent(MotionEvent ev) { ... // 僅貼出關鍵代碼 // 重點分析1:ViewGroup每次事件分發時,都需調用onInterceptTouchEvent()詢問是否攔截事件 if (disallowIntercept || !onInterceptTouchEvent(ev)) { // 判斷值1:disallowIntercept = 是否禁用事件攔截的功能(默認是false),可經過調用requestDisallowInterceptTouchEvent()修改 // 判斷值2: !onInterceptTouchEvent(ev) = 對onInterceptTouchEvent()返回值取反 // a. 若在onInterceptTouchEvent()中返回false(即不攔截事件),就會讓第二個值爲true,從而進入到條件判斷的內部 // b. 若在onInterceptTouchEvent()中返回true(即攔截事件),就會讓第二個值爲false,從而跳出了這個條件判斷 // c. 關於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; // 重點分析2 // 經過for循環,遍歷了當前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); // 判斷當前遍歷的View是否是正在點擊的View,從而找到當前被點擊的View // 如果,則進入條件判斷內部 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; // 條件判斷的內部調用了該View的dispatchTouchEvent() // 即 實現了點擊事件從ViewGroup到子View的傳遞(具體請看下面的View事件分發機制) if (child.dispatchTouchEvent(ev)) { mMotionTarget = child; return true; // 調用子View的dispatchTouchEvent後是有返回值的 // 若該控件可點擊,那麼點擊時,dispatchTouchEvent的返回值一定是true,所以會致使條件判斷成立 // 因而給ViewGroup的dispatchTouchEvent()直接返回了true,即直接跳出 // 即把ViewGroup的點擊事件攔截掉 } } } } } } boolean isUpOrCancel = (action == MotionEvent.ACTION_UP) || (action == MotionEvent.ACTION_CANCEL); if (isUpOrCancel) { mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT; } final View target = mMotionTarget; // 重點分析3 // 若點擊的是空白處(即無任何View接收事件) / 攔截事件(手動複寫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); // 調用ViewGroup父類的dispatchTouchEvent(),即View.dispatchTouchEvent() // 所以會執行ViewGroup的onTouch() ->> onTouchEvent() ->> performClick() ->> onClick(),即本身處理該事件,事件不會往下傳遞(具體請參考View事件的分發機制中的View.dispatchTouchEvent()) // 此處需與上面區別:子View的dispatchTouchEvent() } ... } /** * 分析1:ViewGroup.onInterceptTouchEvent() * 做用:是否攔截事件 * 說明: * a. 返回true = 攔截,即事件中止往下傳遞(需手動設置,即複寫onInterceptTouchEvent(),從而讓其返回true) * b. 返回false = 不攔截(默認) */ public boolean onInterceptTouchEvent(MotionEvent ev) { return false; } // 回到調用原處
/** * 源碼分析:ViewGroup.dispatchTouchEvent() */ public boolean dispatchTouchEvent(MotionEvent ev) { ... // 僅貼出關鍵代碼 // 重點分析1:ViewGroup每次事件分發時,都需調用onInterceptTouchEvent()詢問是否攔截事件 if (disallowIntercept || !onInterceptTouchEvent(ev)) { // 判斷值1:disallowIntercept = 是否禁用事件攔截的功能(默認是false),可經過調用requestDisallowInterceptTouchEvent()修改 // 判斷值2: !onInterceptTouchEvent(ev) = 對onInterceptTouchEvent()返回值取反 // a. 若在onInterceptTouchEvent()中返回false(即不攔截事件),就會讓第二個值爲true,從而進入到條件判斷的內部 // b. 若在onInterceptTouchEvent()中返回true(即攔截事件),就會讓第二個值爲false,從而跳出了這個條件判斷 // c. 關於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; // 重點分析2 // 經過for循環,遍歷了當前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); // 判斷當前遍歷的View是否是正在點擊的View,從而找到當前被點擊的View // 如果,則進入條件判斷內部 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; // 條件判斷的內部調用了該View的dispatchTouchEvent() // 即 實現了點擊事件從ViewGroup到子View的傳遞(具體請看下面的View事件分發機制) if (child.dispatchTouchEvent(ev)) { mMotionTarget = child; return true; // 調用子View的dispatchTouchEvent後是有返回值的 // 若該控件可點擊,那麼點擊時,dispatchTouchEvent的返回值一定是true,所以會致使條件判斷成立 // 因而給ViewGroup的dispatchTouchEvent()直接返回了true,即直接跳出 // 即把ViewGroup的點擊事件攔截掉 } } } } } } boolean isUpOrCancel = (action == MotionEvent.ACTION_UP) || (action == MotionEvent.ACTION_CANCEL); if (isUpOrCancel) { mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT; } final View target = mMotionTarget; // 重點分析3 // 若點擊的是空白處(即無任何View接收事件) / 攔截事件(手動複寫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); // 調用ViewGroup父類的dispatchTouchEvent(),即View.dispatchTouchEvent() // 所以會執行ViewGroup的onTouch() ->> onTouchEvent() ->> performClick() ->> onClick(),即本身處理該事件,事件不會往下傳遞(具體請參考View事件的分發機制中的View.dispatchTouchEvent()) // 此處需與上面區別:子View的dispatchTouchEvent() } ... } /** * 分析1:ViewGroup.onInterceptTouchEvent() * 做用:是否攔截事件 * 說明: * a. 返回true = 攔截,即事件中止往下傳遞(需手動設置,即複寫onInterceptTouchEvent(),從而讓其返回true) * b. 返回false = 不攔截(默認) */ public boolean onInterceptTouchEvent(MotionEvent ev) { return false; } // 回到調用原處
Android
事件分發老是先傳遞到ViewGroup
、再傳遞到View
佈局以下
測試代碼
佈局文件:activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/my_layout" android:layout_width="match_parent" android:layout_height="match_parent" xmlns:app="http://schemas.android.com/apk/res-auto" android:focusableInTouchMode="true" android:orientation="vertical">
<Button android:id="@+id/button1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="按鈕1" />
<Button android:id="@+id/button2" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="按鈕2" />
</LinearLayout>
核心代碼:MainActivity.java
/** * ViewGroup佈局(myLayout)中有2個子View = 2個按鈕 */ public class MainActivity extends AppCompatActivity { Button button1,button2; ViewGroup myLayout; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); button1 = (Button)findViewById(R.id.button1); button2 = (Button)findViewById(R.id.button2); myLayout = (LinearLayout)findViewById(R.id.my_layout); // 1.爲ViewGroup佈局設置監聽事件 myLayout.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Log.d("TAG", "點擊了ViewGroup"); } }); // 2. 爲按鈕1設置監聽事件 button1.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Log.d("TAG", "點擊了button1"); } }); // 3. 爲按鈕2設置監聽事件 button2.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Log.d("TAG", "點擊了button2"); } }); } }
/** * ViewGroup佈局(myLayout)中有2個子View = 2個按鈕 */ public class MainActivity extends AppCompatActivity { Button button1,button2; ViewGroup myLayout; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); button1 = (Button)findViewById(R.id.button1); button2 = (Button)findViewById(R.id.button2); myLayout = (LinearLayout)findViewById(R.id.my_layout); // 1.爲ViewGroup佈局設置監聽事件 myLayout.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Log.d("TAG", "點擊了ViewGroup"); } }); // 2. 爲按鈕1設置監聽事件 button1.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Log.d("TAG", "點擊了button1"); } }); // 3. 爲按鈕2設置監聽事件 button2.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Log.d("TAG", "點擊了button2"); } }); } }
結果測試
從上面的測試結果發現:
Button
時,執行Button.onClick()
,但ViewGroupLayout
註冊的onTouch()
不會執行ViewGroupLayout
的onTouch()
Button
的onClick()
將事件消費掉了,所以事件不會再繼續向下傳遞。從上面ViewGroup
事件分發機制知道,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); } // 說明:只有如下3個條件都爲真,dispatchTouchEvent()才返回true;不然執行onTouchEvent() // 1. mOnTouchListener != null // 2. (mViewFlags & ENABLED_MASK) == ENABLED // 3. mOnTouchListener.onTouch(this, event) // 下面對這3個條件逐個分析 /** * 條件1:mOnTouchListener != null * 說明:mOnTouchListener變量在View.setOnTouchListener()方法裏賦值 */ public void setOnTouchListener(OnTouchListener l) { mOnTouchListener = l; // 即只要咱們給控件註冊了Touch事件,mOnTouchListener就必定被賦值(不爲空) } /** * 條件2:(mViewFlags & ENABLED_MASK) == ENABLED * 說明: * a. 該條件是判斷當前點擊的控件是否enable * b. 因爲不少View默認enable,故該條件恆定爲true */ /** * 條件3:mOnTouchListener.onTouch(this, event) * 說明:即 回調控件註冊Touch事件時的onTouch();需手動複寫設置,具體以下(以按鈕Button爲例) */ button.setOnTouchListener(new OnTouchListener() { @Override public boolean onTouch(View v, MotionEvent event) { return false; } }); // 若在onTouch()返回true,就會讓上述三個條件所有成立,從而使得View.dispatchTouchEvent()直接返回true,事件分發結束 // 若在onTouch()返回false,就會使得上述三個條件不所有成立,從而使得View.dispatchTouchEvent()中跳出If,執行onTouchEvent(event)
/** * 源碼分析:View.dispatchTouchEvent() */ public boolean dispatchTouchEvent(MotionEvent event) { if (mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED && mOnTouchListener.onTouch(this, event)) { return true; } return onTouchEvent(event); } // 說明:只有如下3個條件都爲真,dispatchTouchEvent()才返回true;不然執行onTouchEvent() // 1. mOnTouchListener != null // 2. (mViewFlags & ENABLED_MASK) == ENABLED // 3. mOnTouchListener.onTouch(this, event) // 下面對這3個條件逐個分析 /** * 條件1:mOnTouchListener != null * 說明:mOnTouchListener變量在View.setOnTouchListener()方法裏賦值 */ public void setOnTouchListener(OnTouchListener l) { mOnTouchListener = l; // 即只要咱們給控件註冊了Touch事件,mOnTouchListener就必定被賦值(不爲空) } /** * 條件2:(mViewFlags & ENABLED_MASK) == ENABLED * 說明: * a. 該條件是判斷當前點擊的控件是否enable * b. 因爲不少View默認enable,故該條件恆定爲true */ /** * 條件3:mOnTouchListener.onTouch(this, event) * 說明:即 回調控件註冊Touch事件時的onTouch();需手動複寫設置,具體以下(以按鈕Button爲例) */ button.setOnTouchListener(new OnTouchListener() { @Override public boolean onTouch(View v, MotionEvent event) { return false; } }); // 若在onTouch()返回true,就會讓上述三個條件所有成立,從而使得View.dispatchTouchEvent()直接返回true,事件分發結束 // 若在onTouch()返回false,就會使得上述三個條件不所有成立,從而使得View.dispatchTouchEvent()中跳出If,執行onTouchEvent(event)
接下來,咱們繼續看:onTouchEvent(event)的源碼分析
- 詳情請看註釋
Android 5.0
後View.onTouchEvent()
源碼發生了變化(更加複雜),但原理相同;- 本文爲了讓讀者更好理解,因此採用
Android 5.0
前的版本
/** * 源碼分析:View.onTouchEvent() */ public boolean onTouchEvent(MotionEvent event) { final int viewFlags = mViewFlags; if ((viewFlags & ENABLED_MASK) == DISABLED) { return (((viewFlags & CLICKABLE) == CLICKABLE || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)); } if (mTouchDelegate != null) { if (mTouchDelegate.onTouchEvent(event)) { return true; } } // 若該控件可點擊,則進入switch判斷中 if (((viewFlags & CLICKABLE) == CLICKABLE || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)) { switch (event.getAction()) { // a. 若當前的事件 = 擡起View(主要分析) case MotionEvent.ACTION_UP: boolean prepressed = (mPrivateFlags & PREPRESSED) != 0; ...// 通過種種判斷,此處省略 // 執行performClick() ->>分析1 performClick(); break; // b. 若當前的事件 = 按下View case MotionEvent.ACTION_DOWN: if (mPendingCheckForTap == null) { mPendingCheckForTap = new CheckForTap(); } mPrivateFlags |= PREPRESSED; mHasPerformedLongPress = false; postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout()); break; // c. 若當前的事件 = 結束事件(非人爲緣由) case MotionEvent.ACTION_CANCEL: mPrivateFlags &= ~PRESSED; refreshDrawableState(); removeTapCallback(); break; // d. 若當前的事件 = 滑動View case MotionEvent.ACTION_MOVE: final int x = (int) event.getX(); final int y = (int) event.getY(); int slop = mTouchSlop; if ((x < 0 - slop) || (x >= getWidth() + slop) || (y < 0 - slop) || (y >= getHeight() + slop)) { // Outside button removeTapCallback(); if ((mPrivateFlags & PRESSED) != 0) { // Remove any future long press/tap checks removeLongPressCallback(); // Need to switch from pressed to not pressed mPrivateFlags &= ~PRESSED; refreshDrawableState(); } } break; } // 若該控件可點擊,就必定返回true return true; } // 若該控件不可點擊,就必定返回false return false; } /** * 分析1:performClick() */ public boolean performClick() { if (mOnClickListener != null) { playSoundEffect(SoundEffectConstants.CLICK); mOnClickListener.onClick(this); return true; // 只要咱們經過setOnClickListener()爲控件View註冊1個點擊事件 // 那麼就會給mOnClickListener變量賦值(即不爲空) // 則會往下回調onClick() & performClick()返回true } return false; }
/** * 源碼分析:View.onTouchEvent() */ public boolean onTouchEvent(MotionEvent event) { final int viewFlags = mViewFlags; if ((viewFlags & ENABLED_MASK) == DISABLED) { return (((viewFlags & CLICKABLE) == CLICKABLE || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)); } if (mTouchDelegate != null) { if (mTouchDelegate.onTouchEvent(event)) { return true; } } // 若該控件可點擊,則進入switch判斷中 if (((viewFlags & CLICKABLE) == CLICKABLE || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)) { switch (event.getAction()) { // a. 若當前的事件 = 擡起View(主要分析) case MotionEvent.ACTION_UP: boolean prepressed = (mPrivateFlags & PREPRESSED) != 0; ...// 通過種種判斷,此處省略 // 執行performClick() ->>分析1 performClick(); break; // b. 若當前的事件 = 按下View case MotionEvent.ACTION_DOWN: if (mPendingCheckForTap == null) { mPendingCheckForTap = new CheckForTap(); } mPrivateFlags |= PREPRESSED; mHasPerformedLongPress = false; postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout()); break; // c. 若當前的事件 = 結束事件(非人爲緣由) case MotionEvent.ACTION_CANCEL: mPrivateFlags &= ~PRESSED; refreshDrawableState(); removeTapCallback(); break; // d. 若當前的事件 = 滑動View case MotionEvent.ACTION_MOVE: final int x = (int) event.getX(); final int y = (int) event.getY(); int slop = mTouchSlop; if ((x < 0 - slop) || (x >= getWidth() + slop) || (y < 0 - slop) || (y >= getHeight() + slop)) { // Outside button removeTapCallback(); if ((mPrivateFlags & PRESSED) != 0) { // Remove any future long press/tap checks removeLongPressCallback(); // Need to switch from pressed to not pressed mPrivateFlags &= ~PRESSED; refreshDrawableState(); } } break; } // 若該控件可點擊,就必定返回true return true; } // 若該控件不可點擊,就必定返回false return false; } /** * 分析1:performClick() */ public boolean performClick() { if (mOnClickListener != null) { playSoundEffect(SoundEffectConstants.CLICK); mOnClickListener.onClick(this); return true; // 只要咱們經過setOnClickListener()爲控件View註冊1個點擊事件 // 那麼就會給mOnClickListener變量賦值(即不爲空) // 則會往下回調onClick() & performClick()返回true } return false; }
注:
onTouch()
的執行 先於onClick()
下面我將用Demo
驗證上述的結論
/** * 結論驗證1:在回調onTouch()裏返回false */ // 1. 經過OnTouchListener()複寫onTouch(),從而手動設置返回false button.setOnTouchListener(new View.OnTouchListener() { @Override public boolean onTouch(View v, MotionEvent event) { System.out.println("執行了onTouch(), 動做是:" + event.getAction()); return false; } }); // 2. 經過 OnClickListener()爲控件設置點擊事件,爲mOnClickListener變量賦值(即不爲空),從而往下回調onClick() button.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { System.out.println("執行了onClick()"); } }); /** * 結論驗證2:在回調onTouch()裏返回true */ // 1. 經過OnTouchListener()複寫onTouch(),從而手動設置返回true button.setOnTouchListener(new View.OnTouchListener() { @Override public boolean onTouch(View v, MotionEvent event) { System.out.println("執行了onTouch(), 動做是:" + event.getAction()); return true; } }); // 2. 經過 OnClickListener()爲控件設置點擊事件,爲mOnClickListener變量賦值(即不爲空) // 但因爲dispatchTouchEvent()返回true,即事件再也不向下傳遞,故不調用onClick()) button.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { System.out.println("執行了onClick()"); } });
/** * 結論驗證1:在回調onTouch()裏返回false */ // 1. 經過OnTouchListener()複寫onTouch(),從而手動設置返回false button.setOnTouchListener(new View.OnTouchListener() { @Override public boolean onTouch(View v, MotionEvent event) { System.out.println("執行了onTouch(), 動做是:" + event.getAction()); return false; } }); // 2. 經過 OnClickListener()爲控件設置點擊事件,爲mOnClickListener變量賦值(即不爲空),從而往下回調onClick() button.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { System.out.println("執行了onClick()"); } }); /** * 結論驗證2:在回調onTouch()裏返回true */ // 1. 經過OnTouchListener()複寫onTouch(),從而手動設置返回true button.setOnTouchListener(new View.OnTouchListener() { @Override public boolean onTouch(View v, MotionEvent event) { System.out.println("執行了onTouch(), 動做是:" + event.getAction()); return true; } }); // 2. 經過 OnClickListener()爲控件設置點擊事件,爲mOnClickListener變量賦值(即不爲空) // 但因爲dispatchTouchEvent()返回true,即事件再也不向下傳遞,故不調用onClick()) button.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { System.out.println("執行了onClick()"); } });
測試結果
即:
Activity
、ViewGroup
、View
的事件分發機制
左側虛線:具有相關性 & 逐層返回
已知事件分發過程的核心方法爲:dispatchTouchEvent()
、onInterceptTouchEvent()
和 onTouchEvent()
下面,我將結合總結的工做流程,再次詳細講解該3個方法
狀況1:默認
狀況2:返回true
狀況3:返回false
注:
Activity
、View
都無該方法
狀況1:true
狀況2:false(默認)
狀況1:返回true
狀況2:返回false(default)
下面,我用一段僞代碼來闡述上述3個方法的關係 & 事件傳遞規則
/** * 點擊事件產生後 */ // 步驟1:調用dispatchTouchEvent() public boolean dispatchTouchEvent(MotionEvent ev) { boolean consume = false; //表明 是否會消費事件 // 步驟2:判斷是否攔截事件 if (onInterceptTouchEvent(ev)) { // a. 若攔截,則將該事件交給當前View進行處理 // 即調用onTouchEvent ()方法去處理點擊事件 consume = onTouchEvent (ev) ; } else { // b. 若不攔截,則將該事件傳遞到下層 // 即 下層元素的dispatchTouchEvent()就會被調用,重複上述過程 // 直到點擊事件被最終處理爲止 consume = child.dispatchTouchEvent (ev) ; } // 步驟3:最終返回通知 該事件是否被消費(接收 & 處理) return consume; }
/** * 點擊事件產生後 */ // 步驟1:調用dispatchTouchEvent() public boolean dispatchTouchEvent(MotionEvent ev) { boolean consume = false; //表明 是否會消費事件 // 步驟2:判斷是否攔截事件 if (onInterceptTouchEvent(ev)) { // a. 若攔截,則將該事件交給當前View進行處理 // 即調用onTouchEvent ()方法去處理點擊事件 consume = onTouchEvent (ev) ; } else { // b. 若不攔截,則將該事件傳遞到下層 // 即 下層元素的dispatchTouchEvent()就會被調用,重複上述過程 // 直到點擊事件被最終處理爲止 consume = child.dispatchTouchEvent (ev) ; } // 步驟3:最終返回通知 該事件是否被消費(接收 & 處理) return consume; }
下面,我將經過實例說明常見的事件傳遞狀況 & 流程
View C
上的某個點(圖中黃區)
Action_DOWN
事件在此處產生
通常的事件傳遞場景有:
DOWN
事件MOVE
、UP
)dispatchTouchEvent()
、onTouchEvent()
、onInterceptTouchEvent()
)進行重寫 或 更改返回值U
型)
Activity A ->> ViewGroup B ->> View C
View C ->> ViewGroup B ->> Activity A
注:雖然
ViewGroup B
的onInterceptTouchEvent
()對DOWN
事件返回了false
,但後續的事件(MOVE、UP)
依然會傳遞給它的onInterceptTouchEvent()
這一點與onTouchEvent()
的行爲是不同的:再也不傳遞 & 接收該事件列的其餘事件
設View C
但願處理該點擊事件,即:設置View C
爲可點擊的(Clickable)
或 複寫其onTouchEvent()
返回true
最多見的:設置
Button
按鈕來響應點擊事件
事件傳遞狀況:(以下圖)
DOWN
事件被傳遞給C的onTouchEvent
方法,該方法返回true
,表示處理該事件View C
正在處理該事件,那麼DOWN
事件將再也不往上傳遞給ViewGroup B 和 Activity A
的onTouchEvent()
;(Move、Up)
也將傳遞給View C
的onTouchEvent()
會逐層往
dispatchTouchEvent()
返回,最終事件分發結束
假設ViewGroup B
但願處理該點擊事件,即ViewGroup B
複寫了onInterceptTouchEvent()
返回true
、onTouchEvent()
返回true
事件傳遞狀況:(以下圖)
DOWN
事件被傳遞給ViewGroup B
的onInterceptTouchEvent()
,該方法返回true
,表示攔截該事件,即本身處理該事件(事件再也不往下傳遞)
調用自身的onTouchEvent()
處理事件(DOWN
事件將再也不往上傳遞給Activity A
的onTouchEvent()
)
該事件列的其餘事件(Move、Up)
將直接傳遞給ViewGroup B
的onTouchEvent()
注:
- 該事件列的其餘事件
(Move、Up)
將不會再傳遞給ViewGroup B
的onInterceptTouchEvent
();因:該方法一旦返回一次true
,就不再會被調用- 逐層往
dispatchTouchEvent()
返回,最終事件分發結束
結論
ViewGroup
攔截了一個半路的事件(如MOVE
),該事件將會被系統變成一個CANCEL
事件 & 傳遞給以前處理該事件的子View
;ViewGroup
的onTouchEvent()
ViewGroup
的onTouchEvent()
場景描述
ViewGroup B
無攔截DOWN
事件(仍是View C
來處理DOWN
事件),但它攔截了接下來的MOVE
事件
即
DOWN
事件傳遞到View C
的onTouchEvent()
,返回了true
實例講解
ViewGroup B
的onInterceptTouchEvent()
返回true
攔截該MOVE
事件,但該事件並無傳遞給ViewGroup B
;這個MOVE
事件將會被系統變成一個CANCEL
事件傳遞給View C
的onTouchEvent()
MOVE
事件,該MOVE
事件纔會直接傳遞給ViewGroup B
的onTouchEvent()
後續事件將直接傳遞給
ViewGroup B
的onTouchEvent()
處理,而不會再傳遞給ViewGroup B
的onInterceptTouchEvent()
,因該方法一旦返回一次true,就不再會被調用了。
View C
不再會收到該事件列產生的後續事件至此,關於Android
常見的事件傳遞狀況 & 流程已經講解完畢。
Touch
事件,每次點擊都會觸發一系列action
事件(ACTION_DOWN,ACTION_MOVE,ACTION_UP等)dispatchTouchEvent()
事件分發時,只有前一個事件(如ACTION_DOWN)返回true,纔會收到後一個事件(ACTION_MOVE和ACTION_UP)即若是在執行ACTION_DOWN時返回false,後面一系列的ACTION_MOVE、ACTION_UP事件都不會執行
從上面對事件分發機制分析知:
請記住:接收了ACTION_DOWN事件的函數不必定能收到後續事件(ACTION_MOVE、ACTION_UP)
這裏給出ACTION_MOVE和ACTION_UP事件的傳遞結論:
黑線:ACTION_DOWN事件傳遞方向
紅線:ACTION_MOVE 、 ACTION_UP事件傳遞方向
View
後就再也不往下傳遞,而是直接傳給本身的onTouchEvent()
& 結束本次事件傳遞過程。黑線:ACTION_DOWN事件傳遞方向
紅線:ACTION_MOVE、ACTION_UP事件傳遞方向
View.dispatchTouchEvent()
中調用onTouch()
優先於onTouchEvent
執行;若手動複寫在onTouch()
中返回true
(即 將事件消費掉),將不會再執行onTouchEvent()
注:若1個控件不可點擊(即非
enable
),那麼給它註冊onTouch
事件將永遠得不到執行,具體緣由看以下代碼
// &&爲短路與,即若是前面條件爲false,將再也不往下執行 // 故:onTouch()可以獲得執行需2個前提條件: // 1. mOnTouchListener的值不能爲空 // 2. 當前點擊的控件必須是enable的 mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED && mOnTouchListener.onTouch(this, event) // 對於該類控件,若需監聽它的touch事件,就必須經過在該控件中重寫onTouchEvent()來實現
// &&爲短路與,即若是前面條件爲false,將再也不往下執行 // 故:onTouch()可以獲得執行需2個前提條件: // 1. mOnTouchListener的值不能爲空 // 2. 當前點擊的控件必須是enable的 mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED && mOnTouchListener.onTouch(this, event) // 對於該類控件,若需監聽它的touch事件,就必須經過在該控件中重寫onTouchEvent()來實現
經過閱讀本文,相信您已經能夠全面瞭解Android
事件分發機制
與Android
事件分發最相關的知識:自定義View系列文章
(1)自定義View基礎 - 最易懂的自定義View原理系列
(2)自定義View Measure過程 - 最易懂的自定義View原理系列
(3)自定義View Layout過程 - 最易懂的自定義View原理系列
(4)自定義View Draw過程- 最易懂的自定義View原理系列
接下來我將繼續介紹與Android
事件分發最相關的知識:自定義View,有興趣能夠繼續關注Carson_Ho的安卓開發筆記
相關文章閱讀
Android開發:最全面、最易懂的Android屏幕適配解決方案
Android開發:史上最全的Android消息推送解決方案
Android開發:最全面、最易懂的Webview詳解
Android開發:JSON簡介及最全面解析方法!
Android四大組件:Service服務史上最全面解析
Android四大組件:BroadcastReceiver史上最全面解析