ActivityManager.AppTask.MoveTaskTo メソッド

定義

名前空間:: Android.App

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定した 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

コールバックの呼び出しに使用される Executor

callback: IOutcomeReceiver

要求の結果を受け取るコールバック

属性: RegisterAttribute

注釈

指定した TaskLocation にタスクの位置を変更します。

TaskLocation の境界が無効な場合 (つまり、小さすぎるか、ターゲットディスプレイ内に完全に含まれていない場合)、要求は拒否されます。

再配置要求が承認または拒否されると、コールバックが呼び出されます。要求が承認されると、コールバックは、タスクの新しい表示 ID と境界を含む TaskLocation を受け取ります。最終的な表示 ID と境界は、システムの裁量により、要求された状態から最も近い許容状態に調整できます。

要求が拒否された場合、コールバックは Exception.getMessage() を介してアクセス可能な説明メッセージを含む例外を受け取ります。この例外は、要求元がこのメソッドを使用するために必要なアクセス許可を保持していない場合の SecurityException です。バックグラウンドアクティビティ起動 (BAL) ポリシーの違反により、このタスクを要求どおりに配置できない場合の SecurityException。要求の実行時に TaskLocation をプログラムで変更できる状態でないタスクの場合は IllegalStateException。要求されたターゲットディスプレイにこのタスクを配置できない場合は SecurityException。これは、ディスプレイが信頼されておらず、呼び出し元アプリによって所有されていない場合に発生する可能性があります。指定された TaskLocation に有効な表示 ID が含まれていない場合、または指定された境界が指定されたディスプレイ内に完全に含まれていない場合、または指定された境界が、いずれかの方向で CDD で定義されている最小サイズよりも小さい場合は、IllegalArgumentException。

タスクが元のディスプレイに残っている場合、その z オーダーは影響を受けなくなります。それ以外の場合、タスクが別の表示に移動すると、フォーカスが設定されます。 Manifest.permission.REPOSITION_SELF_WINDOWSが必要

android.app.ActivityManager.AppTask.moveTaskToの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象