Activity.OnWindowFocusChanged(Boolean) Methode

Definition

Namespace:: Android.App

Assembly:: Mono.Android.dll

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 das aktuelle Fenster der Aktivität den Fokus gewinnt oder verliert.

[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

Parameter

hasFocus: Boolean

boolescher Wert: Gibt an, ob das Fenster dieser Aktivität den Fokus hat.

Implementiert

OnWindowFocusChanged(Boolean)

Attribute: RegisterAttribute

Hinweise

Wird aufgerufen, wenn das aktuelle Fenster der Aktivität den Fokus gewinnt oder verliert. Dies ist der beste Indikator dafür, ob diese Aktivität die Entität ist, mit der der Benutzer aktiv interagiert. Die Standardimplementierung löscht den Schlüsselnachverfolgungszustand, daher sollte immer aufgerufen werden. Beachten Sie, dass dies Informationen zum globalen Fokusstatus bereitstellt, der unabhängig vom Aktivitätslebenszyklus verwaltet wird. Während Fokusänderungen im Allgemeinen eine Beziehung zu Lebenszyklusänderungen haben (eine angehaltene Aktivität erhält im Allgemeinen keinen Fensterfokus), sollten Sie sich nicht auf eine bestimmte Reihenfolge zwischen den Rückrufen hier und den anderen Lebenszyklusmethoden wie onResume() verlassen. In der Regel hat eine Vordergrundaktivität jedoch den Fensterfokus... es sei denn, es wurden andere Dialogfelder oder Popups angezeigt, die den Eingabefokus übernehmen. In diesem Fall hat die Aktivität selbst keinen Fokus, wenn die anderen Fenster den Fokus haben. Ebenso kann das System Fenster auf Systemebene (z. B. den Statusleistenbenachrichtigungsbereich oder eine Systemwarnung) anzeigen, die vorübergehend den Fenstereingabefokus einnimmt, ohne die Vordergrundaktivität anzuhalten. Beginnend mit Build.VERSION_CODES. Q kann mehrere fortgesetzte Aktivitäten gleichzeitig im Mehrfenstermodus vorhanden sein. Daher garantiert der fortgesetzte Zustand den Fensterfokus nicht, auch wenn oben keine Überlagerungen vorhanden sind. Wenn sie wissen möchten, wann eine Aktivität am häufigsten aktiv ist, sollte der Benutzer mit der letzten Interaktion zwischen allen Aktivitäten, aber nicht mit Nicht-Aktivitätsfenstern wie Dialogfeldern und Popups interagieren, dann sollte onTopResumedActivityChanged(boolean) verwendet werden. Auf Plattformversionen vor Build.VERSION_CODES. Q, onResume() ist der beste Indikator.

Siehe auch:

Android-Referenz für android.app.Activity.onWindowFocusChanged.

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.

Gilt für: