Activity.OnBackPressed Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wird aufgerufen, wenn die Aktivität das Drücken der Rücktaste des Benutzers erkannt hat.
[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
- Attribute
Hinweise
Wird aufgerufen, wenn die Aktivität das Drücken der Rücktaste des Benutzers erkannt hat. Die Standardimplementierung hängt von der Plattformversion ab:
<ul><li>On platform versions prior to android.os.Build.VERSION_CODES#S, it finishes the current activity, but you can override this to do whatever you want.
<li>
Beginnend mit der Plattformversion android.os.Build.VERSION_CODES#Swerden für Aktivitäten, die die Stammaktivität der Aufgabe sind, und auch eine android.content.IntentFilter mit Intent#ACTION_MAIN und Intent#CATEGORY_LAUNCHER im Manifest deklarieren, die aktuelle Aktivität und deren Aufgabe in die Rückseite des Aktivitätsstapels verschoben, anstatt fertig zu werden. Andere Aktivitäten werden einfach abgeschlossen.
<li>
Wenn Sie diese Methode als Zielversion android.os.Build.VERSION_CODES#S verwenden und diese Methode außer Kraft setzen, wird dringend empfohlen, die Implementierung der Superklassen nach Abschluss der Navigation innerhalb der App aufzurufen.
<li>
Wenn Sie die Version android.os.Build.VERSION_CODES#TIRAMISU oder höher als Ziel verwenden, sollten Sie diese Methode nicht verwenden, sondern eine Registrierung für ein OnBackInvokedCallbackOnBackInvokedDispatcher , das Sie mit #getOnBackInvokedDispatcher()dieser Methode abrufen können. Sie sollten auch im Anwendungsmanifest festlegen android:enableOnBackInvokedCallback="true" .
Alternativ können Sie die Abwärtskompatibilität nutzen androidx.activity.ComponentActivity#getOnBackPressedDispatcher() .
</ul>
Dieses Element ist veraltet. Verwenden oder androidx.activity.OnBackPressedCallback behandeln Sie OnBackInvokedCallback stattdessen die Rückwärtsnavigation.
<p> Ab Android 13 (API-Ebene 33) wechselt die Behandlung von Back-Ereignissen zu einem Vorabmodell und Activity#onBackPressed()KeyEvent#KEYCODE_BACK sollte nicht zum Behandeln von Zurückereignissen (Zurückgesten oder Zurück-Schaltflächenklick) verwendet werden. Stattdessen sollte eine OnBackInvokedCallback registrierung mit Activity#getOnBackInvokedDispatcher()OnBackInvokedDispatcher#registerOnBackInvokedCallback(int, OnBackInvokedCallback) .registerOnBackInvokedCallback(priority, callback).
Java Dokumentation für android.app.Activity.onBackPressed().
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.