SynchronizedInput 控制項模式

說明實作 ISynchronizedInputProvider的指導方針和慣例，包括屬性和方法的相關信息。 SynchronizedInput 控件模式可讓Microsoft UI 自動化用戶端應用程式將滑鼠或鍵盤輸入導向特定的 UI 元素。

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

本主題包含下列各節。

• 實作指導方針和慣例
• ISynchronizedInputProvider 必要成員
• 相關主題

實作指導方針和慣例

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

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

ISynchronizedInputProvider 的必要成員

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

必要成員	成員類型	筆記
StartListening	方法	沒有
取消	方法	沒有
UIA_InputReachedTargetEventId	事件	沒有

 

相關主題

UI 自動化控制項模式概觀