Activity.OnBackPressed メソッド

定義

名前空間:: Android.App

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

アクティビティがユーザーのバックキーの押下を検出したときに呼び出されます。

[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

注釈

アクティビティがユーザーのバックキーの押下を検出したときに呼び出されます。既定の実装は、プラットフォームのバージョンによって異なります。

<ul><li>android.os.Build.VERSION_CODES#Sより前のプラットフォームバージョンでは、現在のアクティビティが完了しますが、これをオーバーライドして任意の操作を実行できます。

<li>

プラットフォームバージョンのandroid.os.Build.VERSION_CODES#S以降では、タスクのルートアクティビティであり、マニフェストでIntent#ACTION_MAINとIntent#CATEGORY_LAUNCHERを使用してandroid.content.IntentFilterを宣言した場合、現在のアクティビティとそのタスクは、完了するのではなく、アクティビティスタックの背面に移動されます。その他のアクティビティは、単純に完了します。

<li>

バージョン android.os.Build.VERSION_CODES#S を対象とし、このメソッドをオーバーライドする場合は、アプリ内でのナビゲーションの処理が完了した後、スーパークラスの実装を呼び出すよう強くお勧めします。

<li>

バージョン android.os.Build.VERSION_CODES#TIRAMISU 以降を対象とする場合は、このメソッドを使用せず、#getOnBackInvokedDispatcher()を使用して取得できるOnBackInvokedDispatcherにOnBackInvokedCallbackを登録する必要があります。また、アプリケーションマニフェストで android:enableOnBackInvokedCallback="true" を設定する必要もあります。

または、下位互換性のために androidx.activity.ComponentActivity#getOnBackPressedDispatcher() を使用することもできます。 </ul>

このメンバーは非推奨です。代わりに、 OnBackInvokedCallback または androidx.activity.OnBackPressedCallback を使用して戻るナビゲーションを処理します。 <p> Android 13 (API レベル 33) 以降では、バックイベント処理は事前のモデルに移行し、 Activity#onBackPressed() し、 KeyEvent#KEYCODE_BACK を使用してバックイベント (バックジェスチャまたは戻るボタンのクリック) を処理しないでください。代わりに、Activity#getOnBackInvokedDispatcher()OnBackInvokedDispatcher#registerOnBackInvokedCallback(int, OnBackInvokedCallback) .registerOnBackInvokedCallback(priority, callback)を使用してOnBackInvokedCallbackを登録する必要があります。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象