辅助功能工具 - 检查

重要

检查 是一个旧版工具。 建议改为使用辅助功能Insights。

检查 (Inspect.exe) 是基于Windows的工具,该工具可用于选择任何 UI 元素并查看元素的可访问性数据。 可以查看 Microsoft UI 自动化属性和控件模式,以及MICROSOFT ACTIVE ACCESSIBILITY (MSAA) 属性。 使用 "检查"还可以测试 UI 自动化 树中自动化元素的导航结构,以及 Microsoft Active Accessibility 层次结构中的可访问对象。

要求

若要UI 自动化,UI 自动化系统上必须存在此数据。 有关详细信息,请参阅的 "要求" UI 自动化。

检查 作为 Windows 软件开发工具包 (SDK) 工具集的一部分安装,不会作为单独的下载进行分发。 Windows SDK 包含本部分中记录的所有与辅助功能相关的工具。

下载 Windows SDK

备注

有关旧版 Windows SDK,请参阅 Windows SDK 和模拟器存档

Inspect.exe 位于 SDK 安装路径的 bin 版本平台> 文件夹中 (通常不必以管理员角色 \ \ < > \ < ) 。

"检查"窗口

" 检查 "窗口有几个主要部分:

  • 标题栏。 显示" 检查 HWND (窗口句柄) 。
  • 菜单栏。 提供对 检查功能 的访问权限。
  • 工具 栏。 提供对 检查功能 的访问权限。
  • 树视图。 将 UI 元素的层次结构呈现为树视图控件,可用于在元素之间导航。
  • 数据视图。 显示所选 UI 元素的所有公开辅助功能属性。

菜单栏中提供的命令也可在工具栏中使用。 下图展示了 Inspect 工具,用于查询记事本中 “编辑” 菜单元素的 UI 自动化属性。

显示检查工具用户界面的屏幕截图

使用检查

启动"检查"时,"树"视图显示当前所选 UI 元素在元素层次结构中的位置,"数据"视图显示所选 UI 元素的属性信息。 可以导航 UI 以查看有关 UI 中每个元素的辅助功能信息。 默认情况下 ,"检查 "跟踪键盘或鼠标焦点。 随着焦点的变化, 数据 视图会使用具有焦点的元素的属性信息进行更新。

若要在 UI 元素之间导航,可以使用以下任一项:

  • 鼠标。
  • 键盘。
  • 树视图中的树 视图 控件。
  • 导航菜单中的 导航 选项。
  • 工具栏中的导航选项。

使用最后三个选项可以导航 UI 的树层次结构。 此树的结构在两种模式UI 自动化Microsoft Active Accessibility略有不同。

验证辅助功能属性信息

" 数据 "视图显示当前选择的 UI 元素的属性信息。 可以配置 "检查 "以显示有关所有辅助功能属性或这些属性子集的信息。 还可以指定其他查看选项,例如 "检查 "是否应保留在其他用户界面的顶部,或 "检查 "是否应该突出显示所选元素周围的边框。 将" 检查"配置为 按需要的方式工作后,可以开始在 UI 元素之间导航并查看属性信息。 检查 在关闭时保存配置设置,并使用它们初始化下一个 检查 会话。

配置属性设置

  1. 在"选项" 菜单中,选择设置...", 或者从工具栏 设置"显示 对话框"。
  2. 在" 在主窗口中显示" 列表中,选择要在"检查"的"数据 " 视图中 显示的属性
  3. "在信息工具提示 中显示"列表中,选择要显示在工具提示中的属性。
  4. 若要查看 UI 元素可能不支持的属性,请选中" 显示不支持的属性" 框。
  5. 单击“确定”。

配置查看选项

  • 在" 选项 "菜单或工具栏中,可以选择以下查看选项。
选择此选项后 检查 会这样做
始终位于顶部 显示在屏幕上的任何其他窗口的顶部。
MSAA 模式 显示Microsoft Active Accessibility属性信息。
UI 自动化模式 显示UI 自动化属性信息。
仅Windows可见视图 仅在 MSAA 模式下可用。
原始视图 在" 树"视图中 UI 自动化树或 MSAA 树的原始视图
控件视图 在" 树"视图中 UI 自动化树的 控件 视图。 仅在UI 自动化模式下可用。
内容视图 在" 树"视图中 UI 自动化树 的内容 视图。 仅在UI 自动化模式下可用。
活动悬停工具栏 在鼠标悬停时激活工具栏按钮,而无需单击鼠标。
出错时发出Epep 在运行或 MSAA 操作期间检测到错误时UI 自动化发出警报。
SPI _ SCREENREADER 标志 假设存在屏幕阅读器。 此标志指示应用程序应以文本方式(而不是图形方式)提供信息。 不应仅仅因为存在屏幕阅读器而设置此标志。
显示突出显示矩形 突出显示具有焦点的元素周围的矩形。
显示 Caret 突出显示 突出显示该点。 仅在 MSAA 模式下可用。
显示信息工具提示 在工具提示中显示属性信息。
观看焦点 跟随键盘焦点。 选中后,将安装异步焦点事件挂钩,将光标移到具有焦点的元素的左上方。 这将导致 检查 在大约一秒后刷新其属性。
监视 Caret 遵循该点。 仅在 MSAA 模式下可用。
监视光标 在光标后。
监视工具提示 遵循工具提示。
显示树 显示" 树" 视图。

验证辅助功能导航

使用"检查"选择 UI元素后,可以验证该元素是否公开了Windows技术产品的自动化导航。

验证辅助功能导航

  1. 打开 " 检查"和要测试的应用程序。
  2. 选择要从中开始导航的 UI 元素。
  3. "数据 "视图中,验证 元素是否公开了与导航相关的正确属性。
  4. 使用 "树"视图、"导航"菜单或工具栏上的导航按钮导航 UI,并验证每个元素是否公开了与导航相关的正确属性。

    备注

    " 导航 "菜单选项和导航工具栏按钮根据所选元素在树中的位置而更改。

与 UI 元素交互

Windows自动化公开了一些方法,这些方法允许辅助技术产品与 UI 元素交互,就像使用鼠标或键盘 (例如,单击某个按钮) 。 "检查 操作"菜单允许测试Windows对元素调用 (自动化方法,例如 Invoke.Invoke 调用 IUIAutomationInvokePattern::Invoke) 。

与 UI 元素交互

  1. 打开 " 检查"和要测试的应用程序。
  2. 选择要与之交互的 UI 元素。
  3. "操作"菜单或工具栏中,选择与要Windows自动化方法对应的操作。

"操作" 菜单包含 " 刷新"和"焦点"项,以及因所选模式UI 自动化 MSAA 模式而异的其他项。 在UI 自动化模式下,其他项反映当前所选 UI 元素支持的控件模式。 在 MSAA 模式下,其他项始终包含以下内容:

操作 说明
刷新 刷新用户界面。 在 MSAA 和 UI 自动化模式下可用。
默认操作 对 元素执行默认操作。
侧重点 设置对 元素的焦点。 在 MSAA 和 UI 自动化模式下可用。
Select 选择 元素。
扩展选择 扩展元素的选择,以包含第一个选定元素和当前元素之间的所有元素。
添加到选定内容 选择当前元素 (如列表项) 。
从选择中删除 从所选内容中删除当前元素。
SetAccValue 将Microsoft Active Accessibility的值设置到指定的字符串。
焦点子级 导航到当前具有焦点的元素的子级。
光标处命中测试 导航到鼠标光标指定的元素的子级。
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
将光标移到光标位于其右侧同级对象 (右) 。 仅在 MSAA 模式下可用。 CTRL+Shift+0