次の方法で共有

アクセシビリティ ツール - AccEvent (アクセシビリティ対応 Event Watcher)

  • [アーティクル]

AccEvent (Accessible Event Watcher) を使用すると、開発者とテスト担当者は、UI の変更が発生したときに、アプリケーションの UI 要素によって適切な Microsoft UI オートメーションと Microsoft Active Accessibility イベントが発生することを検証できます。 UI の変更は、フォーカスが変更されたとき、または UI 要素が呼び出されたとき、選択されたとき、または状態またはプロパティが変更されたときに発生する可能性があります。

AccEvent は、Windows ソフトウェア開発キット (SDK) と共にインストールされます。 SDK インストール パス (Accevent.exe) の \bin\<バージョン>\<platform> フォルダーにあります。

手記

AccEvent は従来のツールです。 代わりに、Accessibility Insights を使用することをお勧めします。

必要条件

AccEvent を使用して、UI オートメーションを持たないシステムのアクセシビリティ データを調べることができます。これは、もともと Microsoft Active Accessibility 用に作成されています。 UI オートメーションを調べるには、UI オートメーションがシステム上に存在する必要があります。 詳細については、UI オートメーション の「要件」セクション参照してください。

AccEvent が Windows SDK のツールセット全体の一部としてインストールされている は、別の exe ダウンロードとして配布されません。 Windows SDK には、このセクションに記載されているすべてのアクセシビリティ関連ツールが含まれています。 Windows SDK を取得します。 (以前のバージョンが必要な場合は、そのページからリンクされた SDK ダウンロード アーカイブもあります)。

AccEvent 実行するには、\bin\<バージョン>\<platform> フォルダーで AccEvent.exe を見つけて実行します (通常は管理者として実行する必要はありません)。

アクセシビリティ対応のイベント ウォッチャー ウィンドウ

AccEvent 起動すると、メイン ウィンドウが表示されます。 AccEvent ウィンドウのメイン には、実行中のアプリケーションによって発生した UI オートメーションまたは Microsoft Active Accessibility イベントが表示されます。 メイン ウィンドウには、次の主要な部分があります。

  • タイトル バー。 現在の動作モードと状態を表示します。
  • メニューバー。 AccEvent 機能へのアクセスを提供します。
  • データ ビュー。 イベント ID や、イベントを発生させた UI 要素の選択されたプロパティなど、各イベントに関する情報を表示します。

AccEvent にはグラフィカル ユーザー インターフェイスのみが含まれます。このツールにはコマンド ライン引数はありませんが、他のツールを使用して出力ログをテキストとして処理できます。

次の図は、AccEvent ウィンドウのメイン を示しています。

アクセス可能なイベント ウォッチャー ツールのユーザー インターフェイスを

アクセシビリティ対応の Event Watcher タスク

このセクションでは、AccEvent タスクでよく使用される について説明します。

動作モードの構成

モード メニューを使用して、AccEvent オペレーティング モードを構成し、ツールの動作を制御する設定を選択します。 次のオプションを選択できます。

このオプションが選択されている場合 AccEvent はこれを行います
Always on Top 画面上の他のユーザー インターフェイスの上に表示されます。
UIA イベント UI オートメーション イベントに関する情報を表示します。
WinEvents (コンテキスト内) サーバー アドレス空間に存在するフック関数に渡される Microsoft Active Accessibility イベント (WinEvents) に関する情報を表示します。 詳細については、「In-Context Hook Functions」を参照してください。
WinEvents (コンテキスト外) クライアント アドレス空間に存在するフック関数に渡される Microsoft Active Accessibility イベント (WinEvents) に関する情報を表示します。 詳細については、「コンテキスト外フック関数の」を参照してください。
強調表示の四角形を表示する 選択したイベントを発生させた UI 要素の周囲の四角形を強調表示します。
情報ツールヒントの表示 ツールヒントにイベント情報を表示します。
設定 [UIA イベント設定] または [WinEvent 設定 ] ダイアログ ボックス 表示します。

 

UI オートメーション イベントのフィルター処理

AccEvent ウィンドウに表示される UI オートメーション イベントとプロパティを構成するには、[モード] メニューをクリックし、[UIA イベント ] を選択し、[設定] 選択します。 [UIA イベント設定] ダイアログ ボックスが表示されます。 このダイアログ ボックスを使用して、イベントをフィルター処理することもできます。

[UIA イベント設定] ダイアログ ボックスには、次のウィンドウが表示されます。

  • グローバル イベント

    FocusChangedEvent] チェック ボックスをオンにして、グローバル フォーカス変更イベントに関する情報を表示します。

  • イベントの種類の

    関心のあるイベントを選択します。

  • スコープ の

    AccEvent イベントをリッスンする UI 要素を選択します。

  • からのイベントを含める

    [スコープ] ウィンドウで選択した UI 要素の直接の子要素からイベントを表示する場合は、[イミディエイトの子 を選択します。 すべての子孫要素のイベントを表示する場合は、[すべての子孫 選択します。

  • レポートのプロパティ

    メイン ウィンドウの各イベントの後に表示するプロパティを選択します。 [モード] メニューで [情報ツールヒントの表示] が選択されている場合は、選択したプロパティもツールヒントに表示されます。

アクティブなアクセシビリティ イベントのフィルター処理

[AccEvent] ウィンドウに表示される Microsoft Active Accessibility イベントとプロパティを構成するには、[モード] メニューをクリックし、[WinEvents (コンテキスト内)] または [WinEvents (コンテキスト外)] をして、[設定]を選択します。 [WinEvent 設定] ダイアログ ボックスが表示されます。 このダイアログ ボックスを使用して、イベントをフィルター処理することもできます。

WinEvent 設定 ダイアログ ボックスには、次のウィンドウが含まれています。

  • オブジェクト

    AccEvent イベントをリッスンするオブジェクトを選択します。 AccEvent は、ウィンドウ、カーソル、キャレットから発生したイベントをリッスンできます。 ウィンドウ は既定で選択されています。

  • イベント

    関心のあるイベントを選択します。 既定では、すべてのイベントが表示されます。

  • イベント情報の

    メイン ウィンドウで各イベントの名前の後に表示する情報を選択します。

  • オブジェクトのプロパティ

    メイン ウィンドウの各イベントの後に表示するプロパティを選択します。 [モード] メニューで [情報ツールヒントの表示] が選択されている場合は、選択したプロパティもツールヒントに表示されます。 Name、Role、および State が既定で選択されています。

  • フィルター処理の

    フィルター セクションのラジオ ボタンのいずれかを選択して、hWNDs フィールドで指定されたウィンドウによって発生したイベントをフィルター処理します。 既定では、[フィルター しない] ラジオ ボタンが選択されています。

    • [除外] ラジオ ボタンを選択すると、指定したウィンドウ以外のオブジェクトから発生したイベントのみが表示されます。
    • [ のみ含める] ラジオ ボタンを選択し、それらのウィンドウから発生したイベントのみを表示する 1 つ以上のウィンドウ ハンドルを指定します。
    • 指定したウィンドウの子孫によって発生したイベントを含めるには、[と子孫の] チェック ボックスをオンにします。

  • オプションの

    次のいずれかのオプションを選択します。

    このオプションが選択されている場合 AccEvent はこれを行います
    呼び出しを使用する IDispatch::Invoke を使用して、IAccessible メソッドを使用するのではなく、オブジェクト のプロパティを取得します。
    常にオブジェクトを取得する (オブジェクトプロパティが選択されていない場合でも) [オブジェクトのプロパティ] ウィンドウで項目が選択されていない場合でも、イベントに関連付けられているオブジェクトを取得します。
    既定のプロパティを表示する (選択したプロパティに加えて) イベントに関連付けられているオブジェクトの既定のプロパティと、[オブジェクトのプロパティ] ウィンドウで選択した項目を表示します (存在する場合)。
    非表示/非表示ウィンドウからイベント情報を表示する 非表示ウィンドウまたは非表示ウィンドウ内のオブジェクトを含むすべてのオブジェクトについて、[イベント情報] ウィンドウから選択した項目を表示します。
    非表示/非表示ウィンドウからイベント情報全体を表示する [イベント情報] ウィンドウから選択した項目と、[オブジェクトのプロパティ] ウィンドウで選択した (または既定の) 項目を、非表示ウィンドウまたは非表示ウィンドウ内のオブジェクトを含むすべてのオブジェクトに対して表示します。
    次のイベントでの DebugBreak 次の WinEvent を開始するプロセスでブレークポイント例外が発生します。 これにより、例外を処理するようにデバッガーに通知されます。

イベント メニューの使用

イベント メニューを使用して、次のタスクを実行します。

このオプションが選択されている場合 AccEvent はこれを行います
リッスンを開始する データ ビューでのイベント情報の表示を開始します。
リッスンを停止する データ ビューでのイベント情報の表示を停止します。
イベント履歴のクリア データ ビューの内容をクリアします。
[すべてのイベントの選択] データ ビューに一覧表示されているすべてのイベントを選択します。
選択したイベントをコピーする 選択したイベントをクリップボードにコピーします。

アクティブなアクセシビリティ イベントの保存

テキスト ファイルへのイベントの保存を開始するには、[ファイル] メニューを開き、[ファイル へのログ記録開始] を選択します。 AccEvent は、[ファイル] メニューから [ログ記録の停止] 選択するまで、指定したファイルへのイベントの書き込みを開始します。 テキスト ファイルは、後でイベントのトラブルシューティングと確認を行う場合に役立ちます。