IUIAutomationSynchronizedInputPattern::StartListening メソッド (uiautomationclient.h)

Microsoft UI オートメーションプロバイダーがマウスまたはキーボード入力のリッスンを開始します。

構文

HRESULT StartListening(
  [in] SynchronizedInputType inputType
);

[in] inputType

リッスンする入力の種類を指定する値の組み合わせ。

型: HRESULT

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

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

指定した型の入力を受け取った後、プロバイダーは入力のチェックを停止し、通常どおり続行します。

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


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