ISynchronizedInputProvider::StartListening メソッド (uiautomationcore.h)
指定した型の入力のリッスンを開始します。
構文
HRESULT StartListening(
[in] SynchronizedInputType inputType
);
パラメーター
[in] inputType
同期を要求される入力の種類。
戻り値
種類: 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 を含む) |