StatusBarManager.ShowPowerMenu(IExecutor, IOutcomeReceiver) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
請求顯示電源選單。
[Android.Runtime.Register("showPowerMenu", "(Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetShowPowerMenu_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)]
public virtual void ShowPowerMenu(Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);
[<Android.Runtime.Register("showPowerMenu", "(Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetShowPowerMenu_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)>]
abstract member ShowPowerMenu : Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.ShowPowerMenu : Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
參數
- executor
- IExecutor
其中 Executor 將 callback 的方法稱為
- receiver
- IOutcomeReceiver
會回撥請求結果或可能的錯誤
- 屬性
備註
請求顯示電源選單。
電源選單是包含關機、重新啟動等選項的對話框。也稱為全球行動
系統可能會限制顯示此對話框,例如若設定DevicePolicyManager.LOCK_TASK_FEATURE_GLOBAL_ACTIONS,則由 DevicePolicyManager 限制。
接收器會在結果中顯示電源選單(若可能)時顯示,或是否關閉電源選單。 如果在提出請求時電源選單目前可見,SHOW_POWER_MENU_RESULT_SHOWING將立即透過回撥回傳。
或者,若因錯誤無法完成請求,則會以 OutcomeReceiver.onError 回傳。 若請求在幾秒後無回應而逾時,則此錯誤可能是 TimeoutException,或是其他 Exception。 在這些錯誤案例中,通常代表系統本身有潛在問題,重試無法成功。
此回撥可重複用於多個請求。 需要Manifest.permission.SHOW_POWER_MENU或Manifest.permission.SHOW_POWER_MENU_PRIVILEGED
Android 參考資料。android.app.StatusBarManager.showPowerMenu
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。