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 所需的成员
实现 ISynchronizedInputProvider 接口需要以下属性、方法和事件。
| 必需成员 | 成员类型 | 笔记 |
|---|---|---|
| StartListening | 方法 | 没有 |
| 取消 | 方法 | 没有 |
| UIA_InputReachedTargetEventId | 事件 | 没有 |
相关主题