Activity.RequestVisibleBehind(Boolean) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
想要保持在上方半透明活動後方可見的活動,必須在 開始 #onResume() 與返回 #onPause()之間的任意時間呼叫此方法。
[Android.Runtime.Register("requestVisibleBehind", "(Z)Z", "GetRequestVisibleBehind_ZHandler")]
public virtual bool RequestVisibleBehind(bool visible);
[<Android.Runtime.Register("requestVisibleBehind", "(Z)Z", "GetRequestVisibleBehind_ZHandler")>]
abstract member RequestVisibleBehind : bool -> bool
override this.RequestVisibleBehind : bool -> bool
參數
- visible
- Boolean
true表示該活動希望被其他半透明活動遮蔽,false則表示相反。 當將 false 傳入此方法時,必須釋放資源。
傳回
產生可見度狀態。 如果是真的,活動會持續可見,即使 #onPause() 下一個活動是半透明還是不是全螢幕。 若為假,則該活動可能無法被其他半透明活動看到,必須停止任何媒體播放並釋放資源。
回傳 false 可能會取代呼叫 , #onVisibleBehindCanceled() 因此必須檢查回傳值。
- 屬性
備註
此方法在 API 等級 26 中被淘汰。 此方法的功能自 Build.VERSION_CODES 日起不再支援。O 並會在未來版本中移除。
想要保持在上方半透明活動後方可見的活動,必須在 onResume() 開始到 onPause() 返回之間的任何時間呼叫此方法。 若此呼叫成功,則在呼叫 onPause() 後,該活動仍可見,並允許在背景繼續播放媒體。 每次將此活動帶到前端時,該呼叫的動作都會被重置。 也就是說,每次呼叫 onResume() 時,該活動都會被假定為沒有請求的可視後方。 因此,如果你想讓這個活動繼續在背景中可見,你必須再次呼叫這個方法。 只有全螢幕不透明的活動才會做出這個決定。 也就是說,這個呼叫是用於對話和透明活動的 NOP。 在任何情況下,活動必須在呼叫 onVisibleBehindCanceled() 之前或期間停止播放並釋放資源,若呼叫回錯。 只要在 onPause 回傳與下一次呼叫 onResume 之間呼叫此方法時,都會回傳 False。
Android 參考資料。android.app.Activity.requestVisibleBehind
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。