ActivityManager.AppTask.RequestWindowingLayer 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.

Fordert die Fensterebene für diese Aufgabe an.

[Android.Runtime.Register("requestWindowingLayer", "(ILjava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetRequestWindowingLayer_ILjava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)]
public virtual void RequestWindowingLayer(int layer, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver callback);

[<Android.Runtime.Register("requestWindowingLayer", "(ILjava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetRequestWindowingLayer_ILjava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)>]
abstract member RequestWindowingLayer : int * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.RequestWindowingLayer : int * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

Parameter

layer: Int32

Der WindowingLayer , in den die Aufgabe verschoben werden soll.

executor: IExecutor

Ein Executor verwendeter Aufruf des Rückrufs.

callback: IOutcomeReceiver

Ein Rückruf zum Empfangen des Ergebnisses der Anforderung.

Attribute: RegisterAttribute

Hinweise

Fordert die Fensterebene für diese Aufgabe an. Dies kann verwendet werden, um die Z-Reihenfolge des Fensters der Aktivität relativ zu anderen Fenstern zu beeinflussen.

Der Vorgang wird nach Möglichkeit auf die angeforderte Ebene verschoben. Wenn die Anforderung genehmigt oder abgelehnt wird, wird der Rückruf aufgerufen. Wenn der Rückruf abgelehnt wird, erhält der Rückruf eine Ausnahme mit einer beschreibenden Nachricht, auf die über Exception.getMessage() zugegriffen werden kann.

Wenn die Anforderung aufgrund eines Systemzustands abgelehnt wird, empfängt der Rückruf AppTask.WINDOWING_LAYER_REQUEST_REJECTED. Wenn die Anforderung gewährt wird, erhält der Rückruf AppTask.WINDOWING_LAYER_REQUEST_GRANTED.

Um die Systemintegrität und eine konsistente Benutzererfahrung sicherzustellen, kann das System Einschränkungen für Aufgaben auferlegen, die eine bestimmte Ebene anfordern. Informationen zu Auswirkungen beim Anfordern der angehefteten Ebene finden Sie unter AppTask.WINDOWING_LAYER_PINNED.

Wenn AppTask.WINDOWING_LAYER_PINNED angefordert wird, muss AppOpsManager.OPSTR_PICTURE_IN_PICTURE zulässig sein, und die Manifest.permission.USE_PINNED_WINDOWING_LAYER Berechtigung muss erteilt werden.

Wenn die Anforderung aufgrund eines Entwicklerfehlers fehlschlägt (z. B. fehlende Berechtigungen oder ungültige Argumente), wird OutcomeReceiver.onError mit einer Ausnahme aufgerufen, die den Fehler beschreibt.

Android-Referenz für android.app.ActivityManager.AppTask.requestWindowingLayer.

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: