ActivityManager.AppTask.MoveTaskTo 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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
執行者用來呼叫回撥
- callback
- IOutcomeReceiver
回撥以接收請求結果
- 屬性
備註
將任務重新定位到指定的 TaskLocation。
若 TaskLocation 的邊界無效（即太小或未完全進入目標顯示範圍），請求將被拒絕。
當重新定位請求被批准或拒絕時，回撥將被啟動。 若請求被核准，回調將收到包含新顯示 ID 及任務界限的 TaskLocation。 最終顯示 ID 與界限可依系統判斷調整至最接近可接受狀態。
若請求被拒絕，回調將收到一個例外，並附帶描述性訊息，可透過 Exception.getMessage（） 存取。 此例外將為以下之一：若請求者未持有使用此方法所需的權限，則為 SecurityException;;若因違反背景活動啟動（BAL）政策，無法依要求放置此任務，則使用 SecurityException;IllegalStateException 若任務未處於允許其在請求執行時程式化更改 TaskLocation 的狀態;如果無法將此任務放置在請求的目標顯示器上，則使用 SecurityException。 當顯示不被信任且不屬於呼叫應用程式所有時，這種情況就可能發生;;IllegalArgumentException 是指所提供的 TaskLocation 未包含有效的顯示 ID，或所提供的界限未完全包含在給定顯示中，或這些界限大小小於 CDD 定義的最小大小，無論哪一方向。
如果任務保持在原始顯示狀態，其 z 順序不會受到影響。 否則，如果任務移到其他顯示器，就會變得聚焦。 需要Manifest.permission.REPOSITION_SELF_WINDOWS
Android 參考資料。android.app.ActivityManager.AppTask.moveTaskTo
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。