Activity.OnBackPressed 方法

[Android.Runtime.Register("onBackPressed", "()V", "GetOnBackPressedHandler")]
public virtual void OnBackPressed();

[<Android.Runtime.Register("onBackPressed", "()V", "GetOnBackPressedHandler")>]
abstract member OnBackPressed : unit -> unit
override this.OnBackPressed : unit -> unit

屬性

RegisterAttribute

備註

此方法在 API 等級 33 中被棄用。 改用 OnBackInvokedCallback 或 androidx.activity.OnBackPressedCallback 來處理回溯導覽。 從 Android 13（API 等級 33）開始，回向事件處理將轉向預先處理模式，而 Activity.onBackPressed（） 和 KeyEvent.KEYCODE_BACK 不應用於處理回傳事件（如倒退手勢或返回按鈕點擊）。 相反地，OnBackInvokedCallback 應該使用 Activity.getOnBackInvokedDispatcher（） .registerOnBackInvokedCallback（priority， callback）註冊。

當活動偵測到使用者按下後鍵時，會被呼叫。 預設實作依平台版本而異：Build.VERSION_CODES之前的平台版本。S，它會完成目前的活動，但你可以覆寫它來做任何你想做的事。 從平台版本Build.VERSION_CODES開始。對於任務的根活動，且在清單中宣告包含 Intent.ACTION_MAIN 和 Intent.CATEGORY_LAUNCHER 的 IntentFilter 的活動，當前活動及其任務將被移至活動堆疊的最後方，而非完成。 其他活動則會直接完成。 如果你鎖定的是版本Build.VERSION_CODES。如果 S 並覆寫此方法，我們強烈建議在完成應用程式內導覽處理後，呼叫超類別實作。 如果你鎖定的是版本Build.VERSION_CODES。TIRAMISU 或更新版本，你不應該使用此方法，而是在 OnBackInvokedDispatcher 註冊一個 OnBackInvokedCallback，你可以使用 getOnBackInvokedDispatcher（） 取得。 你也應該在應用程式清單中設定 android：enableOnBackInvokedCallback=“true”。 或者，你也可以使用 androidx.activity.ComponentActivity.getOnBackPressedDispatcher（） 來向後相容。

另請參閱：

Android 參考資料。android.app.Activity.onBackPressed

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。