用户界面自动化活动

上次更新日期 2025年11月17日

截取屏幕截图

UiPath.UIAutomationNext.Activities.NTakeScreenshot

描述

截取指定用户界面元素或应用程序的屏幕截图，并将其保存为图像文件。

该活动可在“使用应用程序/浏览器”活动内部和外部使用。

如果在“ 使用应用程序/浏览器 ”活动中添加，则仅捕获目标应用程序。如果在应用程序卡外部添加，则由于未指定目标，因此将捕获整个桌面。

此活动可与对象存储库兼容。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows and Cross-platform configuration

“在作用域内工作” - 选择呈现要自动化的网页应用程序的浏览器选项卡。
在屏幕上指定目标 - 指定要用作目标的用户界面元素。

指定目标后，选择加号按钮以访问以下选项：
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
屏幕截图容器 - 在“ 整个页面” 和“ 元素 ”之间进行选择，以截取整个页面或单个元素的屏幕截图。默认选项为“ 整个页面”。
Output to (for Windows) - Use the radio buttons to choose the output type:
- 文件 - 将屏幕截图保存到指定位置的文件。默认选项。
- “图像” - 将屏幕截图保存到指定的图像。
- 剪贴板 - 将屏幕截图另存为剪贴板中的图像，以备后用。

“文件名 ” - 保存指定用户界面元素屏幕截图的文件的名称。

“自动递增” - 定义在文件名冲突的情况下要附加到文件名的内容。从下拉菜单中选择一个选项：
- 无（覆盖） - 文件名将与指定的完全相同，如果已存在另一个同名文件，则该文件名将被覆盖。这是默认选项。
- 索引 - 如果已存在一个或多个与模式 Filename (XX) 匹配的文件，则系统会创建一个名为 Filename (N+1)的新文件，其中 N 是现有文件中的最大索引。
- HH.MM.SS 为 YYYY.MM.DD - 如果已存在具有指定名称的文件，则系统将创建一个名为 Filename YYYY.MM.DD at HH.MM.SS的新文件。如果文件名为 Filename YYYY.MM.DD at HH.MM.SS 的文件已存在，则添加索引（类似于索引用例），从而生成名为 Filename YYYY.MM.DD at HH.MM.SS (1)的文件。

属性面板

输入/输出

屏幕截图文件 - 另存为 .png 文件的屏幕截图。
Input element - The UI element on which the activity is executed, stored in an UIElement object. This field supports only UIElement objects. This object can be obtained from the Output Element property field of other UI Automation activities.
Output element - Outputs a target UI Element and stores it in a UIElement object, which can be further used to target the same element with other activities.

选项

Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。
- 已禁用- 关闭此活动的 Healing Agent。
- 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
- “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
- 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。

“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。此字段仅支持 Boolean 值（True、 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

计时

“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“延迟时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。默认值为 0.3 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。默认值为 30 秒。

Windows - 旧版配置

选择“在应用程序/浏览器中指明” ，以指定用作目标的用户界面元素。

指定目标后，选择“ 菜单” 按钮以访问以下选项：
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
- 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
- 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。
“输出到” - 使用单选按钮选择输出类型：
- 文件 - 将屏幕截图保存到指定位置的文件。默认选项。
- “图像” - 将屏幕截图保存到指定的图像。
- 剪贴板 - 将屏幕截图另存为剪贴板中的图像，以备后用。
File Name - The name of the file where the screenshot of the specified UI element is saved. Click Browse for File, then browse to the folder where to save the screenshot, and specify the file name and extension to use.
自动增量 - 选择在保存屏幕截图时附加到文件名的内容，以防文件名冲突。例如，如果已存在与您保存的文件同名的文件，则选择 “索引” 会保留文件名，为每个屏幕截图创建一个新文件，并为每个屏幕截图连续添加一个索引号。
- 无（覆盖） - 如果已存在同名文件，请将其替换。
- 索引 - 在文件名中添加一个数字，例如 screenshot (1).png。
- YYYY.MM.DD at HH.MM.SS - 在文件名中添加截取屏幕截图的日期和时间，例如 screenshot 2020.06.22 at 10:22:32。

属性面板

常见

“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。此字段仅支持 Boolean 值（True、 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。
“延迟时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。默认值为 0.3 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
显示名称- 设计器面板中活动的显示名称指定目标时，系统会自动生成显示名称。
“超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。默认值为 30 秒。

“自动递增 ” - 请参阅“设计器”面板中的“ 自动递增 ”。
“文件名 ” - 在“设计器”面板中查看“ 文件名 ”。
“目标 ” - 目标元素。必须设置目标元素。在屏幕上指定之前，此字段设置为 (null)。指定目标后，将显示与指定元素相关的所有属性。
- CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
- 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
- “模糊选取器 ” - 模糊选取器的参数。
- 原生文本 - 用于标识用户界面元素的文本。
- 响应式网站 - 启用响应式网站布局。
- “严格选取器 ” - 为用户界面元素生成的“严格选取器”。
- 定位方法 - 要用于标识元素的选取器类型。可以将此属性设置为下拉菜单中的任意组合：
  - 无
  - 精确选取器
  - 模糊选取器
  - 图像
  - 原生文本
  - Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置”>“Computer Vision”，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。
    将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为 True。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后，服务器值将被覆盖。但是，“本地服务器”在跨平台项目中不可用。
  - 语义选取器- 利用大型语言模型 (LLM) 生成功能性、拟人化的用户界面元素描述。这些描述可靠性极高，既能适应用户界面的变更，又能在传统选取器失效时显着增强自动化弹性。
- 可见性检查 - 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
  - “无 ”- 不检查可见性。
  - 交互式（用于模糊选取器） - 默认选项。检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
  - 完全可见 - 检查用户界面元素是否可见。
- 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。您可以从下拉菜单中选择以下三个选项之一：
  - 无- 不等待目标变为就绪状态。
  - “交互式”– 等待直到加载了应用程序的一部分。
  - “完整”– 等待整个应用程序被加载。
- 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时适用。

输入元素 - 用于执行活动的用户界面元素，存储在 UIElement 对象中。此字段仅支持 UIElement 对象。可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中，该对象可进一步用于通过其他活动定位同一元素。