ISynchronizedInputProvider::StartListening メソッド (uiautomationcore.h)

指定した型の入力のリッスンを開始します。

構文

HRESULT StartListening(
  [in] SynchronizedInputType inputType
);

パラメーター

[in] inputType

種類: SynchronizedInputType

同期を要求される入力の種類。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

一致する入力が見つかると、プロバイダーはターゲット UI オートメーション要素が現在の要素と一致するかどうかを確認します。 一致する場合、プロバイダーは UIA_InputReachedTargetEventId イベントを発生させます。それ以外の場合は、 UIA_InputReachedOtherElementEventId または UIA_InputDiscardedEventId イベント が 発生します。 このプロバイダー以外の要素の場合、UI オートメーション プロバイダーは入力を破棄する必要があります。

これはワンショットメソッドです。入力を受け取った後、プロバイダーはリッスンを停止し、正常に続行します。

プロバイダーが既に入力をリッスンしている場合、このメソッドはE_INVALIDOPERATIONを返します。

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム、SP3 を使用した Windows XP、Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム、WINDOWS Server 2003 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	uiautomationcore.h (UIAutomation.h を含む)

こちらもご覧ください

ISynchronizedInputProvider