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

备注：

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

• 19.012.20036
• 19.012.20035
• 19.012.20034
• 19.010.20100
• 19.010.20099
• 19.010.20098
• 19.010.20091
• 19.010.20069
• 19.010.20064
• 19.008.20081
• 19.008.20080
• 19.008.20074
• 19.008.20071

我们建议使用 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

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

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

1. 在 Adobe Reader 中，打开“编辑”菜单，然后从“辅助工具”子菜单中单击“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。

2. 从“阅读顺序”下拉菜单中，选择“标记的阅读顺序”选项。这将指示 Adobe Reader 在读取文档时忽略主动式辅助。

3. 在“阅读模式选项”部分，选择“阅读整个文档”选项。

4. 单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。

   

Adobe Reader DC 18

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

1. 在 Adobe Reader 中，打开“编辑”菜单，然后从“辅助工具”子菜单中单击“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。

2. 从“阅读顺序”下拉列表中，选择“从文档推断阅读顺序”选项。这将指示 Adobe Reader 在读取文档时忽略主动式辅助。

3. 在“阅读模式选项”部分，选择“阅读整个文档”选项。

4. 单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。

   

页面上的单个可见对象

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

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

1. 在 Adobe Reader 中，打开“编辑”菜单，然后从“辅助工具”子菜单中单击“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。

2. 从“阅读顺序”下拉列表中，选择“使用原始打印流中的阅读顺序”选项。这将指示 Adobe Reader 在读取文档时忽略主动式辅助。

3. 在“阅读模式选项”中，选择“阅读整个文档”选项。

4. 单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。

   

Adobe Reader DC 中的安全选项

PDF automation may be affected after upgrading Adobe Reader DC to version 22.003.20258 (see Acrobat Reader Release Notes). It is not possible to identify individual elements in PDF documents, instead the entire document is selected. This problem occurs regardless of the version of the UI Automation activity package.

此问题可能是由 Adobe Reader DC 中提供的安全选项所引起：默认情况下“启动时启用保护模式”处于启用状态。

要解决此问题，请按照以下步骤禁用安全选项：

1. 打开 Adobe Reader。
2. Go to Edit > Preferences.
3. From the Categories list, select Security (Enhanced).
4. 在“沙盒保护”部分中，清除“启动时启用保护模式”复选框。
5. A confirmation is requested. Click Yes to continue, then click OK.
6. 重新启动 Adobe Reader。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。