ISynchronizedInputProvider：：StartListening 方法 (uiautomationcore.h)

  • 發行項

開始接聽指定型別的輸入。

語法

HRESULT StartListening(
  [in] SynchronizedInputType inputType
);

參數

[in] inputType

類型： SynchronizedInputType

要求同步處理的輸入類型。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

當找到相符的輸入時，提供者會檢查目標 使用者介面自動化 專案是否符合目前的元素。 如果相符，提供者會引發 UIA_InputReachedTargetEventId 事件;否則，它會引發 UIA_InputReachedOtherElementEventId 或 UIA_InputDiscardedEventId 事件。 如果 使用者介面自動化 提供者是針對這個以外的專案，則必須捨棄輸入。

這是單次方法;接收輸入之後，提供者會停止接聽並繼續正常。

如果提供者已經接聽輸入，這個方法會傳回E_INVALIDOPERATION。

規格需求

需求 值
最低支援的用戶端 Windows 7、Windows Vista SP2 和 Windows Vista 平臺更新、Windows XP SP3 和 Windows Vista 平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

ISynchronizedInputProvider