ContentCaptureSession.Flush 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

會清除內部的 UI 事件緩衝區，並向系統智慧（SI）發出訊號，表示已達到語意有意義的狀態。

[Android.Runtime.Register("flush", "()V", "GetFlushHandler", ApiSince=36)]
public virtual void Flush();

[<Android.Runtime.Register("flush", "()V", "GetFlushHandler", ApiSince=36)>]
abstract member Flush : unit -> unit
override this.Flush : unit -> unit

會清除內部的 UI 事件緩衝區，並向系統智慧（SI）發出訊號，表示已達到語意有意義的狀態。 SI 利用此訊號來重建視圖階層並理解 UI 的當前狀態。

UI 事件常常會被批次處理，以出於效能考量。語意批次代表一連串事件，當依序應用時，會產生有意義且完整的 UI 狀態。

完成語意批次後呼叫 flush() 非常重要，以確保 SI 能準確重建視圖階層。

<b>過早沖洗：</b> 在語意批次中呼叫 flush() 可能導致 SI 無法正確重建視圖階層。這可能導致兄弟節點的錯誤排序。

<b>延遲沖洗：</b> 雖然語義批次後不立即沖洗通常是安全的，但建議盡快沖洗。在最壞情況下，若從未呼叫 a，SI flush() 會根據視角出現與消失事件，在短暫延遲後嘗試處理事件。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。