Activity.OnBackPressed Méthode

[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

Attributs

RegisterAttribute

Remarques

Cette méthode a été déconseillée au niveau de l’API 33. Utilisez OnBackInvokedCallback ou androidx.activity.OnBackPressedCallback pour gérer la navigation arrière à la place. À partir d’Android 13 (niveau d’API 33), la gestion des événements de retour passe à un modèle à l’avance et Activity.onBackPressed() et KeyEvent.KEYCODE_BACK ne doivent pas être utilisés pour gérer les événements précédents (mouvement précédent ou clic sur le bouton Précédent). Au lieu de cela, un OnBackInvokedCallback doit être inscrit à l’aide de Activity.getOnBackInvokedDispatcher() .registerOnBackInvokedCallback(priority, callback).

Appelé lorsque l’activité a détecté la pression de l’utilisateur sur la touche Précédent. L’implémentation par défaut dépend de la version de la plateforme : sur les versions de plateforme antérieures à Build.VERSION_CODES. S, il termine l’activité actuelle, mais vous pouvez le remplacer pour faire ce que vous souhaitez. À compter de la version de la plateforme Build.VERSION_CODES. S, pour les activités qui sont l’activité racine de la tâche et déclarent également un IntentFilter avec Intent.ACTION_MAIN et Intent.CATEGORY_LAUNCHER dans le manifeste, l’activité actuelle et sa tâche sont déplacées vers l’arrière de la pile d’activités au lieu d’être terminées. D’autres activités seront simplement terminées. Si vous ciblez la version Build.VERSION_CODES. S et remplacer cette méthode, nous vous recommandons vivement d’appeler l’implémentation de superclasse une fois que vous avez terminé la gestion de la navigation au sein de l’application. Si vous ciblez la version Build.VERSION_CODES. TIRAMISU ou version ultérieure, vous ne devez pas utiliser cette méthode, mais inscrire un OnBackInvokedCallback sur un OnBackInvokedDispatcher que vous pouvez récupérer à l’aide de getOnBackInvokedDispatcher(). Vous devez également définir android :enableOnBackInvokedCallback="true » dans le manifeste de l’application. Vous pouvez également utiliser androidx.activity.ComponentActivity.getOnBackPressedDispatcher() pour la compatibilité descendante.

Voir aussi :

Référence Android pour android.app.Activity.onBackPressed.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.