アクセシビリティ ツール - AccEvent (アクセシビリティ対応 Event Watcher)
AccEvent (アクセシビリティ対応 Event Watcher) を使用すると、開発者とテスト担当者は、UI の変更が発生したときに、アプリケーションの UI 要素によって適切な Microsoft UI オートメーションおよび Microsoft Active Accessibility イベントが発生することを検証できます。 UI の変更は、フォーカスが変更されたとき、または UI 要素が呼び出されたとき、選択されたとき、または状態またはプロパティが変更されたときに発生する可能性があります。
AccEvent は、Windows ソフトウェア開発キット (SDK) と共にインストールされます。 これは、SDK のインストール パス (Accevent.exe) の \bin\<version>\<platform> フォルダーにあります。
Note
AccEvent は従来のツールです。 代わりにアクセシビリティ インサイトを使用することをお勧めします。
要件
AccEvent は、もともと Microsoft Active Accessibility 用に作成されたUI オートメーションを持たないシステム上のアクセシビリティ データを調べるために使用できます。 UI オートメーションを調べるには、UI オートメーションがシステムに存在している必要があります。 詳細については、UI オートメーションの「要件」セクションを参照してください。
AccEvent は、Windows SDK のツールの全体的なセットの一部としてインストールされ、別の exe ダウンロードとして配布されません。 Windows SDK には、このセクションに記載されているすべてのアクセシビリティ関連のツールが含まれています。 Windows SDK を取得します。 (以前のバージョンが必要な場合は、そのページからリンクされた SDK ダウンロード アーカイブもあります)。
AccEvent を実行するには、\bin\version>\<<platform> フォルダーでAccEvent.exeを見つけて実行します (通常は管理者として実行する必要はありません)。
アクセシビリティ対応イベントウォッチャー ウィンドウ
AccEvent を起動すると、メイン ウィンドウが表示されます。 メインの AccEvent ウィンドウには、実行中のアプリケーションによって発生したUI オートメーションまたは Microsoft Active Accessibility イベントが表示されます。 メイン ウィンドウには、次の主要な部分があります。
- タイトル バー。 現在の動作モードと状態を表示します。
- メニュー バー。 AccEvent 機能へのアクセスを提供します。
- データ ビュー。 イベント ID や、イベントを発生させた UI 要素の選択したプロパティなど、各イベントに関する情報を表示します。
AccEvent にはグラフィカル ユーザー インターフェイスのみが含まれます。このツールにはコマンド ライン引数はありませんが、他のツールを使用して出力ログをテキストとして処理できます。
次の図は、メインの AccEvent ウィンドウを示しています。
アクセシビリティ対応のイベント 監視タスク
このセクションには、一般的に使用される AccEvent タスクに関する情報が含まれています。
動作モードの構成
[モード] メニューを使用して AccEvent 操作モードを構成し、ツールの動作を制御する設定を選択します。 次のオプションを選択できます。
| このオプションが選択されている場合 | AccEvent はこれを行います |
|---|---|
| 常に手前に表示 | 画面上の他のユーザー インターフェイスの上に表示されます。 |
| UIA イベント | UI オートメーション イベントに関する情報を表示します。 |
| WinEvents (コンテキスト内) | サーバーのアドレス空間に存在するフック関数に渡される Microsoft Active Accessibility イベント (WinEvents) に関する情報を表示します。 詳細については、「 コンテキスト内フック関数」を参照してください。 |
| 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 は、ウィンドウ、カーソル、またはキャレットから発生したイベントをリッスンできます。 ウィンドウ は既定で選択されています。
イベント
関心のあるイベントを選択します。 既定では、すべてのイベントが表示されます。
イベント情報
メイン ウィンドウで各イベントの名前の後に表示する情報を選択します。
オブジェクトのプロパティ
メイン ウィンドウの各イベントの後に表示するプロパティを選択します。 [モード] メニューで [情報ツールヒントの表示] が選択されている場合は、選択したプロパティもツールヒントに表示されます。 既定では、名前、 ロール、 および状態 が選択されています。
フィルター処理
フィルター セクションのラジオ ボタンのいずれかを選択して、 hWNDs フィールドで指定されたウィンドウによって発生したイベントをフィルター処理します。 既定では、[ フィルターを適用しない ] ラジオ ボタンが選択されています。
- [ 除外 ] ラジオ ボタンを選択すると、指定したウィンドウ以外のオブジェクトから発生したイベントのみが表示されます。
- [ インクルードのみ ] ラジオ ボタンを選択し、1 つ以上のウィンドウ ハンドルを指定して、それらのウィンドウから発生したイベントのみを表示します。
- 指定したウィンドウ の子孫 によって発生したイベントを含めるには、[子孫] チェック ボックスをオンにします。
[オプション]
次のいずれかのオプションをクリックします。
このオプションが選択されている場合 AccEvent はこれを行います Invoke を使用する IAccessible メソッドを使用する代わりに、IDispatch::Invoke を使用してオブジェクトのプロパティを取得します。 Always Get Object (オブジェクト プロパティが選択されていない場合でも) [オブジェクトのプロパティ] ウィンドウで項目が選択されていない場合でも、イベントに関連付けられているオブジェクトを取得します。 既定のプロパティを表示する (選択したプロパティに加えて) イベントに関連付けられているオブジェクトの既定のプロパティ (存在する場合) と、[オブジェクトのプロパティ] ウィンドウで選択した項目を表示します。 非表示/非表示ウィンドウからイベント情報を表示する 非表示ウィンドウまたは非表示ウィンドウ内のオブジェクトを含むすべてのオブジェクトについて、[イベント情報] ウィンドウから選択した項目を表示します。 非表示/非表示ウィンドウから完全なイベント情報を表示する [イベント情報] ウィンドウから選択した項目と、[オブジェクトのプロパティ] ウィンドウから選択した (または既定の) 項目を、非表示ウィンドウまたは非表示ウィンドウのオブジェクトを含むすべてのオブジェクトに対して表示します。 次のイベントでの DebugBreak 次の WinEvent を開始するプロセスでブレークポイント例外が発生します。 これにより、デバッガーが例外を処理するように通知されます。
イベント メニューの使用
[イベント] メニューを使用して、次のタスクを実行します。
| このオプションが選択されている場合 | AccEvent はこれを行います |
|---|---|
| リッスンを開始する | データ ビューでのイベント情報の表示を開始します。 |
| リッスンを停止する | データ ビューでのイベント情報の表示を停止します。 |
| イベント履歴のクリア | データ ビューの内容をクリアします。 |
| [すべてのイベントの選択] | データ ビューに一覧表示されているすべてのイベントを選択します。 |
| 選択したイベントをコピーする | 選択したイベントをクリップボードにコピーします。 |
アクティブなアクセシビリティ イベントの保存
イベントをテキスト ファイルに保存するには、[ ファイル ] メニューを開き、[ ファイルへのログ記録の開始] を選択します。 AccEvent は、[ファイル] メニューから [ログ記録の 停止 ] を選択するまで、指定したファイルへのイベント の 書き込みを開始します。 テキスト ファイルは、後でイベントのトラブルシューティングや確認を行う場合に役立ちます。