jaccessinspector

説明

jaccessinspectorツールを使用すると、次のような場合に、オブジェクト・アクセシビリティ情報を調べるための様々な方法を選択できます。

フォーカスの変更、マウスの移動、プロパティ変更、メニュー選択、ポップアップ・メニューの表示といったイベントが発生した場合
マウスがオブジェクト上にあるときに[F1]キーを押したか、マウスがウィンドウ上にあるときに[F2]キーを押した場合

調査対象のオブジェクトが選択されていると、jaccessinspectorツールには、そのオブジェクトに対してJava Accessibility APIメソッドを呼び出した結果が表示されます。

jaccessinspectorツールの実行

Javaアプリケーションを起動してから、次のコマンドを実行してjaccessinspectorツールを起動します。

ノート:

JAVA_HOMEは環境変数であり、c:\Program Files\Java\jdk-11などのJDKまたはJREのパスに設定する必要があります。

%JAVA_HOME%\bin\jaccessinspector.exe

このとき、Javaアプリケーション・ウィンドウとjaccessinspectorウィンドウの2つのウィンドウが開きます。jaccessinspectorウィンドウには、次の5つのメニューがあります。

「UpdateSettings」、「JavaEvents」および「AccessibilityEvents」の各メニューの項目を使用すると、様々な方法でJavaアプリケーションに問い合せることができます。

「File」メニュー

この項では、「File」メニューの項目について説明します。

AccessBridge DLL Loaded: AccessBridge DLLのロードを有効または無効にします。
Exit: ツールを終了します。

「UpdateSettings」メニュー

この項では、「UpdateSettings」メニューの項目について説明します。

Update from Mouse: マウスの動きが停止したときにマウスのx座標とy座標を特定し(jaccessinspectorツール・ウィンドウが一番上にあることが前提)、マウスの真下にあるアクセス可能オブジェクトをJavaアプリケーションに問い合せて、出力をjaccessinspectorウィンドウにダンプします。
Update with F2 (Mouse HWND): マウスのx座標とy座標を特定し(jaccessinspectorツール・ウィンドウが一番上にあることが前提)、マウスの真下にあるHWNDのアクセス可能オブジェクトをJavaアプリケーションに問い合せて、出力をjaccessinspectorウィンドウにダンプします。
Update with F1 (Mouse Point): マウスのx座標とy座標を特定し(jaccessinspectorツール・ウィンドウが一番上にあることが前提)、カーソルの真下にあるアクセス可能オブジェクトをJavaアプリケーションに問い合せて、出力をjaccessinspectorウィンドウにダンプします。

「JavaEvents」メニュー

この項では、「JavaEvents」メニューの項目について説明します。

Track Mouse Events: すべてのJavaマウス入力イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、カーソルで入力されたオブジェクトを問い合せて、出力をjaccessinspectorウィンドウにダンプします。

ノート:
マウスを素早く動かすと、表示された情報が更新されるまでに時間がかかることがあります。
Track Focus Events: すべてのJavaフォーカス取得イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、フォーカスを受け取ったオブジェクトを問い合せて、出力をjaccessinspectorウィンドウにダンプします。
Track Caret Events: すべてのJavaキャレット更新イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、キャレットが更新されたオブジェクトを問い合せて、出力をjaccessinspectorウィンドウにダンプします。

ノート:
キャレットを含むオブジェクトは、定義上ほとんど必然的にリッチ・テキスト・オブジェクトであるため、他のイベント追跡オプションほど反応が早いように見えません。実際の使用では、キャレット更新の場合(たとえば、キャレットの位置にある新しい文字、単語、文を取得するなど)でのアクセシビリティ・コールは少なくなり、大幅に速くなります。
Track Menu Selected | Deselected | Canceled Events: すべてのメニュー・イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、キャレットが更新されたオブジェクトを問い合せて、出力をjaccessinspectorウィンドウにダンプします。
Track Popup Visible | Invisible | Cancelled Events: すべてのポップアップ・メニュー・イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、キャレットが更新されたオブジェクトを問い合せて、出力をjaccessinspectorウィンドウにダンプします。
Track Shutdown Events: Javaアプリケーションが終了したときにプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。

「AccessibilityEvents」メニュー

この項では、「AccessibilityEvents」メニューの項目について説明します。

ノート:

「AccessibilityEvents」メニューに表示される項目は、アプリケーション、特に支援テクノロジ・アプリケーションのテストで最も重要です。

Track Name Property Events: 特にNameプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をスクロール・ウィンドウにダンプします。
Track Description Property Events: 特にDescriptionプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をjaccessinspectorウィンドウにダンプします。
Track State Property Events: 特にStateプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をjaccessinspectorウィンドウにダンプします。
Track Value Property Events: 特にValueプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をスクロール・ウィンドウにダンプします。
Track Selection Property Events: 特にSelectionプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をjaccessinspectorウィンドウにダンプします。
Track Text Property Events: 特にTextプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をjaccessinspectorウィンドウにダンプします。
Track Caret Property Events: 特にCaretプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をjaccessinspectorウィンドウにダンプします。
Track VisibleData Property Events: 特にVisibleDataプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をjaccessinspectorウィンドウにダンプします。
Track Child Property Events: 特にChildプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をjaccessinspectorウィンドウにダンプします。
Track Active Descendent Property Events: 特にActive Descendentプロパティが変更されたアクセス可能オブジェクトに対するすべてのJavaプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をjaccessinspectorウィンドウにダンプします。
Track Table Model Change Property Events: 特にTable Model Changeプロパティが変更されたアクセス可能オブジェクトに対するすべてのプロパティ変更イベントを受信するように、Javaアプリケーションに登録します。イベントの受信時に、変更されたプロパティに関する情報とともに出力をjaccessinspectorウィンドウにダンプします。

「Options」メニュー

この項では、「Options」メニューの項目について説明します。

Monitor the same events as JAWS: JAWSでもモニターされているイベントのみのモニタリングを有効にします。
Monitor All Events: jaccessinspectorウィンドのすべてのイベントのモニタリングを有効にします。
Reset All Events: 選択したオプションをデフォルト設定にリセットします。
Go To Message: メッセージ番号を入力すると記録されたメッセージを表示できる「Go To Message」ダイアログを開きます。
Clear Message History: jaccessinspectorウィンドウから記録されたメッセージの履歴をクリアします。