语言

ActivityManager.AppTask.MoveTaskTo 方法

定义

将任务重新定位到指定的 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

参数

location
TaskLocation

TaskLocation 具有目标显示,或者 Display#INVALID_DISPLAY 目标显示是否为当前显示,以及新的所需边界

executor
IExecutor

用于调用回调的执行程序

callback
IOutcomeReceiver

用于接收请求结果的回调

特性

注解

将任务重新定位到指定的 TaskLocation。

如果 TaskLocation 的边界无效(即目标显示内太小或未完全),将拒绝请求。

当重新定位请求获得批准或拒绝时,将调用回调。 如果请求获得批准,回调将收到一个 TaskLocation,其中包含任务的新显示 ID 和边界。 最终的显示 ID 和边界可以调整为系统自由裁量请求状态中最接近的可接受状态。

如果请求被拒绝,回调将收到一个异常,其中包含通过 Exception.getMessage(可访问的描述性消息)。 此异常将是下列情况之一:如果请求者不持有使用此方法所需的权限,则 SecurityException;如果由于违反后台活动启动 (BAL) 策略而无法按请求放置此任务,则 SecurityException;;如果任务不处于允许它在请求运行时以编程方式更改 TaskLocation 的状态,则为 IllegalStateException;;如果无法将此任务置于请求的目标显示上,则 SecurityException。 当显示不受信任且不受调用应用拥有时,可能会发生这种情况;;如果提供的 TaskLocation 不包括有效的显示 ID,或者提供的边界未完全包含在给定显示器内,或者提供的边界小于 CDD 中定义的最小大小,则为 IllegalArgumentException。

如果任务保持其原始显示状态,则其 z 顺序不会受到影响。 否则,如果任务移动到其他显示,它将变为焦点。 需要Manifest.permission.REPOSITION_SELF_WINDOWS

Android 参考。android.app.ActivityManager.AppTask.moveTaskTo

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于