Activity.OnBackPressed Método

[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

Atributos

RegisterAttribute

Comentários

Esse método foi preterido no nível 33 da API. Use OnBackInvokedCallback ou androidx.activity.OnBackPressedCallback para manipular a navegação de volta. A partir do Android 13 (nível de API 33), a manipulação de eventos back está se movendo para um modelo de tempo anterior e Activity.onBackPressed() e KeyEvent.KEYCODE_BACK não deve ser usada para lidar com eventos de retorno (gesto de voltar ou clique no botão voltar). Em vez disso, um OnBackInvokedCallback deve ser registrado usando Activity.getOnBackInvokedDispatcher() .registerOnBackInvokedCallback(priority, callback).

Chamado quando a atividade detectou a pressão do usuário da tecla de fundo. A implementação padrão depende da versão da plataforma: nas versões da plataforma antes do Build.VERSION_CODES. S, ele conclui a atividade atual, mas você pode substituir isso para fazer o que quiser. Começando com a versão da plataforma Build.VERSION_CODES. S, para atividades que são a atividade raiz da tarefa e também declaram um IntentFilter com Intent.ACTION_MAIN e Intent.CATEGORY_LAUNCHER no manifesto, a atividade atual e sua tarefa serão movidas para a parte de trás da pilha de atividades em vez de serem concluídas. Outras atividades serão simplesmente concluídas. Se você direcionar a versão Build.VERSION_CODES. S e substituir esse método, é altamente recomendável chamar para a implementação de superclasse depois que você terminar de lidar com a navegação dentro do aplicativo. Se você direcionar a versão Build.VERSION_CODES. TIRAMISU ou posterior, você não deve usar esse método, mas registrar um OnBackInvokedCallback em um OnBackInvokedDispatcher que você pode recuperar usando getOnBackInvokedDispatcher(). Você também deve definir android:enableOnBackInvokedCallback="true" no manifesto do aplicativo. Como alternativa, você pode usar androidx.activity.ComponentActivity.getOnBackPressedDispatcher() para compatibilidade com versões anteriores.

Consulte também:

Referência do Android para android.app.Activity.onBackPressed.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.