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

Positioniert den Vorgang an der angegebenen TaskLocationPosition.

[Android.Runtime.Register("moveTaskTo", "(Landroid/app/TaskLocation;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetMoveTaskTo_Landroid_app_TaskLocation_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)]
public virtual void MoveTaskTo(Android.App.TaskLocation location, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver callback);

[<Android.Runtime.Register("moveTaskTo", "(Landroid/app/TaskLocation;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetMoveTaskTo_Landroid_app_TaskLocation_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)>]
abstract member MoveTaskTo : Android.App.TaskLocation * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.MoveTaskTo : Android.App.TaskLocation * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

Parameter

location: TaskLocation

TaskLocation mit der Zielanzeige oder Display#INVALID_DISPLAY wenn die Zielanzeige die aktuelle Anzeige ist, und die neuen gewünschten Grenzen

executor: IExecutor

ein Executor, der zum Aufrufen des Rückrufs verwendet wird

callback: IOutcomeReceiver

ein Rückruf zum Empfangen des Ergebnisses der Anforderung

Attribute: RegisterAttribute

Hinweise

Positioniert den Vorgang an die angegebene TaskLocation.

Wenn die Grenzen der TaskLocation ungültig sind (d. h. zu klein oder nicht vollständig innerhalb der Zielanzeige), wird die Anforderung abgelehnt.

Wenn die Neupositionierungsanforderung genehmigt oder abgelehnt wird, wird der Rückruf aufgerufen. Wenn die Anforderung genehmigt wurde, empfängt der Rückruf eine TaskLocation mit der neuen Anzeige-ID und den Grenzen der Aufgabe. Die endgültige Anzeige-ID und die Grenzen können nach Ermessen des Systems an die nächstgelegenen zulässigen Zustände angepasst werden.

Wenn die Anforderung abgelehnt wird, erhält der Rückruf eine Ausnahme mit einer beschreibenden Nachricht, auf die über Exception.getMessage() zugegriffen werden kann. Diese Ausnahme ist eine der folgenden: SecurityException, wenn der Antragsteller nicht über die berechtigung verfügt, die für die Verwendung dieser Methode erforderlich ist; SecurityException, wenn diese Aufgabe aufgrund eines Verstoßes gegen die Bal-Richtlinie (Background Activity Launch) nicht wie angefordert platziert werden kann;; IllegalStateException, wenn sich die Aufgabe nicht in einem Zustand befindet, der es ermöglicht, seine TaskLocation programmgesteuert zur Laufzeit der Anforderung zu ändern;; SecurityException, wenn diese Aufgabe nicht auf der angeforderten Zielanzeige platziert werden kann. Dies kann passieren, wenn die Anzeige nicht vertrauenswürdig ist und nicht der aufrufenden App gehört; IllegalArgumentException, wenn die angegebene TaskLocation keine gültige Anzeige-ID enthält oder die bereitgestellten Grenzen nicht vollständig in der angegebenen Anzeige enthalten sind oder die bereitgestellten Grenzen kleiner als die in der CDD in beiden Richtungen definierte Mindestgröße sind.

Wenn der Vorgang auf der ursprünglichen Anzeige verbleibt, ist die Z-Reihenfolge nicht betroffen. Andernfalls wird die Aufgabe in eine andere Anzeige verschoben, sodass sie fokussiert wird. Erfordert Manifest.permission.REPOSITION_SELF_WINDOWS

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

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: