Langue

Activity.OnWindowFocusChanged(Boolean) Méthode

Définition

Appelé lorsque la fenêtre actuelle de l’activité gagne ou perd le focus.

[Android.Runtime.Register("onWindowFocusChanged", "(Z)V", "GetOnWindowFocusChanged_ZHandler")]
public virtual void OnWindowFocusChanged(bool hasFocus);
[<Android.Runtime.Register("onWindowFocusChanged", "(Z)V", "GetOnWindowFocusChanged_ZHandler")>]
abstract member OnWindowFocusChanged : bool -> unit
override this.OnWindowFocusChanged : bool -> unit

Paramètres

hasFocus
Boolean

booléen : indique si la fenêtre de cette activité a le focus.

Implémente

Attributs

Remarques

Appelé lorsque la fenêtre actuelle de l’activité gagne ou perd le focus. Il s’agit du meilleur indicateur de savoir si cette activité est l’entité avec laquelle l’utilisateur interagit activement. L’implémentation par défaut efface l’état de suivi des clés. Elle doit donc toujours être appelée. Notez que cela fournit des informations sur l’état global du focus, qui est géré indépendamment du cycle de vie de l’activité. Par conséquent, bien que les modifications de focus aient généralement une relation avec les changements de cycle de vie (une activité qui est arrêtée n’obtiendra généralement pas le focus de fenêtre), vous ne devez pas vous appuyer sur un ordre particulier entre les rappels ici et ceux dans les autres méthodes de cycle de vie telles que onResume(). Toutefois, en règle générale, une activité de premier plan aura le focus de fenêtre... sauf s’il a affiché d’autres dialogues ou fenêtres contextuelles qui prennent le focus d’entrée, auquel cas l’activité elle-même n’aura pas le focus lorsque les autres fenêtres l’ont. De même, le système peut afficher des fenêtres au niveau du système (telles que le panneau de notification de la barre d’état ou une alerte système) qui prend temporairement le focus d’entrée de fenêtre sans interrompre l’activité de premier plan. À partir de Build.VERSION_CODES. Q il peut y avoir plusieurs activités reprise en même temps en mode multi-fenêtre, de sorte que l’état repris ne garantit pas le focus de fenêtre même s’il n’y a pas de superpositions ci-dessus. Si l’intention est de savoir quand une activité est la plus active, celle avec laquelle l’utilisateur a interagité pour la dernière fois parmi toutes les activités, mais pas les fenêtres autres que les fenêtres d’activité telles que les boîtes de dialogue et les fenêtres contextuelles, alors onTopResumedActivityChanged(booléen) doit être utilisé. Sur les versions de plateforme antérieures à Build.VERSION_CODES. Q, onResume() est le meilleur indicateur.

Voir aussi :

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

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.

S’applique à