SynchronizedInput 控件模式

介绍实现 ISynchronizedInputProvider 的准则和约定，包括有关属性和方法的信息。 SynchronizedInput 控件模式使 Microsoft UI 自动化客户端应用程序能够将鼠标或键盘输入定向到特定的 UI 元素。

此控件模式通常在自动测试脚本中用于将鼠标或键盘输入发送到特定的用户界面元素，然后验证该元素是否收到了输入。

本主题包含以下各节：

实现准则和约定

实现 SynchronizedInput 控件模式时，请注意以下准则和约定：

调用 ISynchronizedInputProvider：：StartListening 方法时，UI 自动化提供程序应开始检查指定类型的输入，然后执行以下操作之一：
- 找到元素的匹配输入时，提供程序应引发 UIA_InputReachedTargetEventId 事件。
- 当找到匹配的输入，但到达不同的元素时，提供程序应引发 UIA_InputReachedOtherElementEventId 事件。
- 当找到不匹配的输入时，提供程序应放弃输入并引发 UIA_InputDiscardedEventId 事件。
如果UI 自动化提供程序对于当前元素以外的元素，则必须放弃输入。
当元素接收输入时，或者调用 ISynchronizedInputProvider：：Cancel 方法时，提供程序停止检查输入并继续正常。
如果在提供程序已侦听输入时调用 ISynchronizedInputProvider：：StartListening ，则提供程序应返回 UIA_E_INVALIDOPERATION。

实现 ISynchronizedInputProvider 接口需要以下属性、方法和事件。

必需的成员	成员类型	说明
StartListening	方法	无
取消	方法	无
UIA_InputReachedTargetEventId	事件	无