辅助功能工具 - 检查
重要
检查是旧工具。 建议改为 辅助功能见解。
检查(Inspect.exe)是基于 Windows 的工具,可以选择任何 UI 元素并查看其辅助功能数据。 可以查看Microsoft UI 自动化属性和控件模式以及Microsoft活动辅助功能(MSAA)属性。 检查还可以测试 UI 自动化树中自动化元素的导航结构以及Microsoft活动辅助功能层次结构中的可访问对象。
要求
若要检查 UI 自动化,必须在系统上显示 UI 自动化。 有关详细信息,请参阅 Run-Time 要求。
检查作为 Windows 软件开发工具包(SDK)中的工具之一进行安装,其中包括本节中记录的所有辅助功能相关工具。 检查不会作为单独的下载分发。
注意
有关较旧版本的 Windows SDK,请参阅 Windows SDK 和模拟器存档。
Inspect.exe 位于 SDK 安装路径的 \bin\<版本>\<平台> 文件夹中。 通常不需要以管理员身份运行它。
“检查”窗口
“检查”窗口有多个主要部分:
- 标题栏。 显示 检查 窗口句柄(HWND)。
- 菜单栏。 提供对检查功能的访问权限。
- 工具栏。 提供对检查功能的访问权限。
- 树视图。 将 UI 元素的分层结构呈现为树视图控件,可用于在元素之间导航。
- 数据视图。 显示所选 UI 元素的所有公开辅助功能属性。
菜单栏中提供的命令也可以在工具栏中使用。 下图显示了“检查”查询记事本中 编辑 菜单元素的 UI 自动化属性。
使用检查
启动“检查”时,树视图会显示元素层次结构中当前所选 UI 元素的位置,而数据视图显示所选 UI 元素的属性信息。 可以导航 UI 以查看有关 UI 中每个元素的辅助功能信息。 默认情况下,检查会跟踪键盘或鼠标焦点。 当焦点发生更改时,数据视图会使用具有焦点的元素的属性信息进行更新。
若要在 UI 元素之间导航,可以使用以下任一元素:
- 鼠标。
- 键盘。
- 树视图中的树视图控件。
- 导航 菜单中的导航选项。
- 工具栏中的导航选项。
最后三个选项使你能够导航 UI 的树层次结构。 此树的结构在 UI 自动化和Microsoft活动辅助功能模式之间可能略有不同。
验证辅助功能属性信息
数据视图显示当前选定的 UI 元素的属性信息。 可配置“检查”以显示有关所有辅助功能属性或这些属性子集的信息。 还可以指定其他查看选项,例如“检查”窗口是否保留在其他用户界面之上,或者“检查”是否突出显示所选元素周围的边界矩形。
将“检查”配置为按所需方式工作后,开始在 UI 元素之间导航并查看属性信息。 检查会在配置设置关闭时保存,并使用这些设置初始化下一个检查会话。
若要配置属性设置,请执行以下步骤:
- 在 选项 菜单中,选择 设置,或从工具栏中选择 显示设置 对话框。
- 在主窗口 列表中的“ 显示”列表中,选择要显示在“检查”的数据视图中的属性。
- 在 信息工具提示 列表中,选择要显示在工具提示中的属性。
- 若要查看 UI 元素可能不支持的属性,请选择 显示不支持的属性。
- 选择“确定”保存更改。
若要配置查看选项,可以在 选项 菜单或工具栏中选择以下查看选项。
验证辅助功能导航
使用“检查”选择 UI 元素后,可以验证该元素是否为辅助技术产品公开了正确的 Windows 自动化导航。
若要验证辅助功能导航,请执行以下步骤:
打开“检查”和要测试的应用程序。
选择要从中开始导航的 UI 元素。
在数据视图中,验证元素是否公开了正确的导航相关属性。
使用树视图、导航 菜单或工具栏上的导航按钮导航 UI,并验证每个元素是否公开了正确的导航相关属性。
注意
导航 菜单选项和导航工具栏按钮会根据所选元素在树中的位置而更改。
与 UI 元素交互
Windows 自动化公开了允许辅助技术产品与 UI 元素交互的方法,就像使用鼠标或键盘一样,例如按下按钮。 “检查 作”菜单允许测试人员在元素上调用 Windows 自动化方法,例如使用 Invoke.Invoke
调用 IUIAutomationInvokePattern::Invoke 方法。
若要与 UI 元素交互,请执行以下步骤:
- 打开“检查”和要测试的应用程序。
- 选择要与之交互的 UI 元素。
- 在 作 菜单或工具栏中,选择要调用的 Windows 自动化方法对应的作。
作 菜单包含 刷新 和 焦点 项,以及其他项因选择 UI 自动化模式还是 MSAA 模式而异。 在 UI 自动化模式下,其他项反映当前所选 UI 元素支持的控件模式。 在 MSAA 模式下,其他项始终包含以下作:
行动 | 描述 |
---|---|
刷新 | 刷新用户界面。 在 MSAA 和 UI 自动化模式下可用。 |
默认作 | 执行元素的默认作。 |
重点 | 设置对元素的焦点。 在 MSAA 和 UI 自动化模式下可用。 |
选择 | 选择元素。 |
扩展选择 | 扩展元素的选择,以包括第一个选定元素和当前元素之间的所有元素。 |
添加到所选内容 | 选择当前元素,例如列表项。 |
从所选内容中删除 | 从所选内容中删除当前元素。 |
SetAccValue | 将元素Microsoft活动辅助功能值设置为指定的字符串。 |
重点子级 | 导航到当前具有焦点的元素的子级。 |
Cursor 中的 HitTest | 导航到鼠标光标指定的元素的子级。 |
HitTest... | 打开“HitTest”对话框。 |
键盘快捷方式
即使“检查”不是活动应用程序,也可以使用键盘快捷方式调用许多菜单项。 快捷键可能会与某些应用程序冲突。
以下键盘快捷键激活菜单上的各种选项:
若要执行此作,请执行以下作 | 使用此键盘快捷方式 |
---|---|
调用光标下对象的默认作(执行默认作)。 仅在 MSAA 模式下可用。 | Ctrl+Shift+F2 |
选择光标下的对象(选择)。 仅在 MSAA 模式下可用。 | Ctrl+Shift+F3 |
将键盘焦点设置为光标下的对象(焦点)。 | Ctrl+Shift+F4 |
从光标下的同级对象移动到上一个同级对象。 此命令仅导航到容器中的对象(上一个同级)。 | Ctrl+Shift+F5 |
移动到对象的父级 (Parent)。 | Ctrl+Shift+F6 |
移动到当前对象的第一个子级(第一个子级)。 | Ctrl+Shift+F7 |
从光标下的同级对象移动到下一个同级对象。 此命令仅导航到容器中的对象(下一个同级)。 | Ctrl+Shift+F8 |
移动到当前对象的最后一个子级(最后一个子级)。 | Ctrl+Shift+F9 |
移动到鼠标光标下的对象(Cursor命中测试)。 仅在 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 |
移动到光标位于光标右侧的同级对象(右)。 仅在 MSAA 模式下可用。 | Ctrl+Shift+0 |