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 所創建與分享的作品,並依授權條款所描述的使用進行修改。