SynchronizedInput 控制項模式

描述實作 ISynchronizedInputProvider的指導方針和慣例，包括屬性和方法的相關資訊。 SynchronizedInput控制項模式可讓 Microsoft 消費者介面自動化用戶端應用程式將滑鼠或鍵盤輸入導向至特定 UI 元素。

此控制項模式通常用於自動化測試腳本，將滑鼠或鍵盤輸入傳送至特定的使用者介面元素，然後確認元素已收到輸入。

本主題包含下列各節。

實作方針和慣例

實作 SynchronizedInput 控制項模式時，請注意下列指導方針和慣例：

呼叫ISynchronizedInputProvider：：StartListening方法時，消費者介面自動化提供者應該開始檢查指定類型的輸入，然後採取下列其中一個動作：
- 找到專案的相符輸入時，提供者應該引發 UIA_InputReachedTargetEventId 事件。
- 找到相符的輸入，但到達不同的元素時，提供者應該引發 UIA_InputReachedOtherElementEventId 事件。
- 找到不相符的輸入時，提供者應該捨棄輸入並引發 UIA_InputDiscardedEventId 事件。
如果輸入是目前元素以外的專案，則消費者介面自動化提供者必須捨棄輸入。
當專案收到輸入，或呼叫 ISynchronizedInputProvider：：Cancel 方法時，提供者會停止檢查輸入，並繼續正常。
如果在提供者已經接聽輸入時呼叫 ISynchronizedInputProvider：：StartListening ，提供者應該會 傳回UIA_E_INVALIDOPERATION。

實作 ISynchronizedInputProvider 介面時，需要下列屬性、方法和事件。

必要成員	成員類型	備註
StartListening	方法	無
取消	方法	無
UIA_InputReachedTargetEventId	事件	無