アクセシビリティ ツール - 検査
大事な
Inspect は従来のツールです。 代わりに、Accessibility Insights を することをお勧めします。
Inspect (Inspect.exe) は、任意の UI 要素を選択してそのアクセシビリティ データを表示できる Windows ベースのツールです。 Microsoft UI オートメーション プロパティとコントロール パターンと Microsoft Active Accessibility (MSAA) プロパティの両方を表示できます。 検査では、UI オートメーション ツリーのオートメーション要素と、Microsoft Active Accessibility 階層内のアクセシビリティ対応オブジェクトのナビゲーション構造をテストすることもできます。
必要条件
UI オートメーションを調べるには、UI オートメーションがシステム上に存在する必要があります。 詳細については、「Run-Time 要件」を参照してください。
Inspect は、Windows ソフトウェア開発キット (SDK) のツールの 1 つとしてインストールされます。このツールには、このセクションに記載されているすべてのアクセシビリティ関連のツールが含まれています。 検査は個別のダウンロードとして配布されません。
Windows SDKをダウンロードします。
Inspect.exe は、SDK インストール パスの \bin\<バージョン>\<platform> フォルダーにあります。 通常、管理者として実行する必要はありません。
[検査] ウィンドウ
検査 ウィンドウには、いくつかの主要な部分があります。
- タイトル バー。 検査 ウィンドウ ハンドル (HWND) を表示します。
- メニューバー。 Inspect 機能へのアクセスを提供します。
- ツールバー。 Inspect 機能へのアクセスを提供します。
- ツリー ビュー。 UI 要素の階層構造を、要素間の移動に使用できるツリー ビュー コントロールとして示します。
- データ ビュー。 選択した UI 要素に対して公開されているすべてのアクセシビリティ プロパティを表示します。
メニュー バーで使用できるコマンドは、ツール バーでも使用できます。 次の図は、メモ帳の Edit メニュー要素の UI オートメーション プロパティのクエリを検査する方法を示しています。
Inspect の使用
Inspect を開始すると、ツリー ビューには要素階層内で現在選択されている UI 要素の場所が表示され、データ ビューには選択した UI 要素のプロパティ情報が表示されます。 UI 内のすべての要素に関するアクセシビリティ情報を表示するには、UI 内を移動します。 既定では、Inspect はキーボードまたはマウスフォーカスを追跡します。 フォーカスが変更されると、データ ビューはフォーカスのある要素のプロパティ情報で更新されます。
UI 要素間を移動するには、次のいずれかの要素を使用できます。
- マウス。
- キーボード。
- ツリー ビューのツリー ビュー コントロール。
- ナビゲーション メニューのナビゲーション オプション。
- ツール バーのナビゲーション オプション。
最後の 3 つのオプションを使用すると、UI のツリー階層を移動できます。 このツリーの構造は、UI オートメーションと Microsoft Active Accessibility モードで若干異なる場合があります。
アクセシビリティ プロパティの情報を確認する
データ ビューには、現在選択されている UI 要素のプロパティ情報が表示されます。 すべてのアクセシビリティ プロパティまたはそれらのプロパティのサブセットに関する情報を表示するように Inspect を構成できます。 また、[検査] ウィンドウが他のユーザー インターフェイスの上に残っているか、選択した要素の周囲の外接する四角形を強調表示するかどうかなど、他の表示オプションを指定することもできます。
必要に合った方法で Inspect を構成したら、UI 要素間の移動とプロパティ情報の表示を開始します。 Inspect は、閉じると構成設定を保存し、それらを使用して次の Inspect セッションを初期化します。
プロパティ設定を構成するには、次の手順に従います。
- [オプション] メニューの [設定] 選択するか、ツール バーから [設定の表示] ダイアログ 選択します。
- [メイン ウィンドウに表示 ] 一覧で、[検査] の [データ] ビューに表示するプロパティを選択します。
- [情報ツールヒント に表示する] ボックスの一覧で、ヒントに表示するプロパティを選択します。
- UI 要素がサポートしていない可能性があるプロパティを表示するには、[サポートされていないプロパティ 表示]を選択します。
- [OK] 選択して変更を保存します。
表示オプションを構成するには、[オプション] メニューまたはツール バーで次の表示オプションを選択します。
| このオプションが選択されている場合 | 検査 がこのアクションを実行する |
|---|---|
| Always on Top | 画面上の他のウィンドウの上に表示されます。 |
| MSAA モード | Microsoft Active Accessibility プロパティ情報を表示します。 |
| UI オートメーション モード | UI オートメーションのプロパティ情報を表示します。 |
| 表示ウィンドウのみ表示 | MSAA モードでのみ使用できます。 |
| 未加工ビュー | ツリー ビューの UI オートメーション ツリーまたは MSAA ツリーの 生のビュー を表示します。 |
| コントロール ビュー | ツリー ビューの UI オートメーション ツリーの コントロール ビュー を表示します。 UI オートメーション モードでのみ使用できます。 |
| コンテンツ ビュー | ツリー ビューの UI オートメーション ツリーの コンテンツ ビューを表示します。 UI オートメーション モードでのみ使用できます |
| アクティブなホバー ツール バー | マウス をクリックする必要なく、マウス ホバー時にツール バー ボタンをアクティブにします。 |
| エラー時にビープ音が鳴る | UI オートメーションまたは MSAA 操作中にエラーが検出されると、ビープ音が鳴ります。 |
| SPI_SCREENREADER フラグ | スクリーン リーダーが存在することを前提としています。 このオプションは、アプリケーションがグラフィカルではなくテキストで情報を提供する必要があることを示します。 スクリーン リーダーが存在するため、このフラグが設定されていると想定しないでください。 |
| 強調表示の四角形を表示する | フォーカスのある要素の周囲の四角形を強調表示します。 |
| キャレットの強調表示を表示する | キャレットを強調表示します。 MSAA モードでのみ使用できます。 |
| 情報ツールヒントの表示 | ツールヒントにプロパティ情報を表示します。 |
| フォーカスを見る | キーボード フォーカスに従います。 選択すると、非同期フォーカス イベント フックがインストールされ、キャレットがフォーカスのある要素の左上に移動します。 この操作により、Inspect は約 1 秒でプロパティを更新します。 |
| キャレットを見る | キャレットに従います。 MSAA モードでのみ使用できます。 |
| カーソルの監視 | カーソルの後に移動します。 |
| ツールヒントを見る | ツールヒントに従います。 |
| ツリーの表示 | ツリー ビューを表示します。 |
アクセシビリティ ナビゲーションを確認する
Inspect を使用して UI 要素を選択すると、要素が支援技術製品用の適切な Windows Automation ナビゲーションを公開していることを検証できます。
アクセシビリティ ナビゲーションを確認するには、次の手順に従います。
Inspect とテストするアプリケーションを開きます。
ナビゲーションを開始する UI 要素を選択します。
データ ビューで、要素が正しいナビゲーション関連のプロパティを公開していることを確認します。
ツリー ビュー、ナビゲーション メニュー、またはツール バーのナビゲーション ボタンを使用して UI を移動し、各要素が正しいナビゲーション関連のプロパティを公開していることを確認します。
手記
ナビゲーション メニュー オプションとナビゲーション ツール バー ボタンは、選択した要素がツリー内のどこにあるかによって変わります。
UI 要素を操作する
Windows Automation では、支援技術製品が、ボタンを押すなど、マウスやキーボードを使用しているかのように UI 要素と対話できるようにするメソッドを公開します。 [アクションの検査] メニューを使用すると、テスト担当者は要素に対して Windows Automation メソッドを呼び出すことができます。たとえば、Invoke.Invoke を使用して IUIAutomationInvokePattern::Invoke メソッドを呼び出すことができます。
UI 要素を操作するには、次の手順に従います。
- Inspect とテストするアプリケーションを開きます。
- 対話する UI 要素を選択します。
- アクション メニューまたはツール バーから、呼び出す Windows Automation メソッドに対応するアクションを選択します。
[アクション] メニューには、[の更新] と [フォーカス] 項目と、UI オートメーション モードと MSAA モードのどちらを選択するかによって異なるその他の項目が含まれています。 UI オートメーション モードでは、他の項目には、現在選択されている UI 要素でサポートされているコントロール パターンが反映されます。 MSAA モードでは、他の項目は常に次のアクションで構成されます。
| アクション | 形容 |
|---|---|
| リフレッシュ | ユーザー インターフェイスを更新します。 MSAA および UI オートメーション モードで使用できます。 |
| 既定のアクション | 要素の既定のアクションを実行します。 |
| 焦点 | 要素にフォーカスを設定します。 MSAA および UI オートメーション モードで使用できます。 |
| 選ぶ | 要素を選択します。 |
| 選択範囲の拡張 | 最初に選択した要素と現在の要素の間のすべての要素を含むように、要素の選択を拡張します。 |
| 選択範囲に追加 | リスト アイテムなどの現在の要素を選択します。 |
| 選択範囲から削除 | 選択範囲から現在の要素を削除します。 |
| SetAccValue | 要素の Microsoft Active Accessibility 値を指定した文字列に設定します。 |
| フォーカスされた子 | 現在フォーカスがある要素の子に移動します。 |
| カーソル位置の HitTest | マウス カーソルで指定された要素の子に移動します。 |
| HitTest... | HitTest ダイアログを開きます。 |
キーボード ショートカット
Inspect がアクティブなアプリケーションでない場合でも、多くのメニュー項目をキーボード ショートカットで呼び出すことができます。 ショートカット キーは、一部のアプリケーションと競合する可能性があります。
次のキーボード ショートカット キーを使用すると、メニューのさまざまなオプションがアクティブになります。
| このオプションを実行するには | このキーボード ショートカットを使用する |
|---|---|
| カーソルの下にあるオブジェクトの既定のアクションを呼び出します (既定のアクションを実行)。 MSAA モードでのみ使用できます。 | Ctrl + Shift + F2 |
| カーソルの下にあるオブジェクトを選択します ([選択])。 MSAA モードでのみ使用できます。 | Ctrl + Shift + F3 |
| カーソルの下のオブジェクトにキーボード フォーカスを設定します (フォーカス)。 | Ctrl + Shift + F4 |
| カーソルの下の兄弟オブジェクトから前の兄弟オブジェクトに移動します。 このコマンドは、コンテナー内のオブジェクトにのみ移動します (前の兄弟)。 | Ctrl + Shift + F5 |
| オブジェクトの親 (親) に移動します。 | Ctrl + Shift + F6 |
| 現在のオブジェクトの最初の子 (最初の子) に移動します。 | Ctrl + Shift + F7 |
| カーソルの下にある次の兄弟オブジェクトに移動します。 このコマンドは、コンテナー内のオブジェクトにのみ移動します (次の兄弟)。 | Ctrl + Shift + F8 |
| 現在のオブジェクトの最後の子 (最後の子) に移動します。 | Ctrl + Shift + F9 |
| マウス カーソルの下のオブジェクトに移動します (カーソルで HitTest を)。 MSAA モードでのみ使用できます。 | Ctrl + Shift + 1 |
| データ ビューの内容をクリップボードにコピーします ([すべてコピー])。 | Ctrl + Shift + 4 |
| データ ビューの内容を更新します (更新)。 | Ctrl + Shift + 5 |
| フォーカスがあるオブジェクトを監視します ([フォーカスの監視])。 | Ctrl + Shift + 6 |
| カーソルの上にある兄弟オブジェクトの左側に移動します (左)。 MSAA モードでのみ使用できます。 | Ctrl + Shift + 7 |
| カーソルが置くオブジェクトの上にある兄弟オブジェクトに移動します (上)。 MSAA モードでのみ使用できます。 | Ctrl + Shift + 8 |
| カーソルの上にある兄弟オブジェクトに移動します (下)。 MSAA モードでのみ使用できます。 | Ctrl + Shift + 9 |
| カーソルの上にある兄弟オブジェクトの右側に移動します (Right)。 MSAA モードでのみ使用できます。 | Ctrl + Shift + 0 |