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 イベント なし

 

UI オートメーション コントロール パターンの概要