ActivityManager.AppTask.MoveTaskTo Méthode

Définition

Espace de noms:: Android.App

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Repositionne la tâche sur l’objet spécifié TaskLocation.

[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

Paramètres

location: TaskLocation

TaskLocation avec l’affichage cible ou Display#INVALID_DISPLAY si l’affichage cible est l’affichage actuel et les nouvelles limites souhaitées

executor: IExecutor

un exécuteur utilisé pour appeler le rappel

callback: IOutcomeReceiver

rappel pour recevoir le résultat de la demande

Attributs: RegisterAttribute

Remarques

Repositionne la tâche sur la TaskLocation spécifiée.

Si les limites de TaskLocation ne sont pas valides (c’est-à-dire trop petites ou pas entièrement à l’intérieur de l’affichage cible), la requête est rejetée.

Lorsque la demande de repositionnement est approuvée ou rejetée, le rappel est appelé. Si la demande est approuvée, le rappel reçoit une TaskLocation contenant le nouvel ID d’affichage et les limites de la tâche. L’ID d’affichage final et les limites peuvent être ajustés aux états acceptables les plus proches des états demandés à la discrétion du système.

Si la demande est rejetée, le rappel reçoit une exception avec un message descriptif accessible via Exception.getMessage(). Cette exception est l’une des suivantes : SecurityException si le demandeur ne contient pas l’autorisation requise pour utiliser cette méthode ; SecurityException si cette tâche ne peut pas être placée comme demandée en raison d’une violation de la stratégie de lancement d’activité en arrière-plan ;; IllegalStateException si la tâche n’est pas dans un état qui lui permet de modifier sa TaskLocation par programmation lors de l’exécution de la requête ;; SecurityException si cette tâche ne peut pas être placée sur l’affichage cible demandé. Cela peut se produire lorsque l’affichage n’est pas approuvé et n’appartient pas à l’application appelante ; IllegalArgumentException si la TaskLocation fournie n’inclut pas d’ID d’affichage valide ou si les limites fournies ne sont pas entièrement contenues dans l’affichage donné ou si les limites fournies sont inférieures à la taille minimale définie dans le CDD dans les deux sens.

Si la tâche reste sur son affichage d’origine, son ordre z n’est pas affecté. Sinon, si la tâche se déplace vers un autre affichage, elle devient prioritaire. Nécessite Manifest.permission.REPOSITION_SELF_WINDOWS

Référence Android pour android.app.ActivityManager.AppTask.moveTaskTo.

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 à