在 PDF 中使用辅助功能选项来识别用户界面元素

备注：

以下版本的 Adobe Reader DC 不支持检测无标记 PDF 文件中的用户界面元素：

我们建议使用 Adobe Reader DC 18 或 Adobe Reader DC 19.012.20040 或更高版本。

主动式辅助是一种 API，它为残障人士或者存在认知困难的认识提供了更好的阅读支持。在程序（如 Adobe Reader）中启用主动式辅助时，用户界面元素的访问、标识或操作可能变得困难或容易出错。

在 Studio 中，这意味着 PDF 文件页面上的元素被作为一个整体来识别，而不是单独识别。

下面是您在 PDF 文件中可能遇到的用户界面元素识别问题的几个例子，以及这些问题的解决方法。

自 UiPath.UIAutomation.Activities 包 v19.5.0 版起，更改当前文档的阅读选项窗口将会自动打开，且会根据您的屏幕指示选中相应选项。不过，若您在元素选取时仍遇到问题，我们建议您手动调整“辅助”选项，如下所述。

标记的 PDF 文档

在此场景中，PDF 文件包含页面内容中的元信息。这意味着辅助选项读取嵌入的信息（作为一个整体，而不是可见的页面元素），并将其呈现给用户界面探测器。这会干扰对页面本身中各个元素的检测，如下所示：

请注意，只有在 Adobe Reader DC 19.012.20040 或更高版本中，才支持从无标记 PDF 文件中选取用户界面元素。您需要标记 PDF 文件，以便交互式用户界面元素选择发挥作用。

在 PDF 文件标记之后，您需要选择以下选项：

要解决这个问题，需要通过以下步骤更改文档辅助阅读顺序：

在 Adobe Reader 中，打开编辑菜单，然后单击“辅助工具”子菜单中的“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。
从阅读顺序下拉列表中，选择“根据文档推断阅读顺序”选项。这将指示 Adobe Reader 在阅读文档时忽略 Active Accessibility。
在阅读模式选项部分，选择“阅读整个文档”选项。
单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。

在这里，文档包含一个在页面上可见的主动式辅助对象，该对象由多个元素（如文本和图片）组成。但是，当通过辅助选项进行打印或读取时，对象将被分解为单独元素。这里的问题是一样的，您可以看到：

同样，解决方法是更改文档的辅助阅读顺序，如下所示：

在 Adobe Reader 中，打开编辑菜单，然后单击“辅助工具”子菜单中的“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。
从阅读顺序下拉列表中，选择“在原始打印流中使用阅读顺序”选项。这将指示 Adobe Reader 在阅读文档时忽略 Active Accessibility。
在阅读模式选项中，选择“阅读整个文档”选项。
单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。