截取屏幕截图

UiPath.UIAutomationNext.Activities.NTakeScreenshot

描述

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

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

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

• 单击 “在应用程序/浏览器 中指定”，以指定要用作目标的用户界面元素。

  指定目标后，选择“ 菜单” 按钮以访问以下选项：

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。
  • 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
  • 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。

• “输出到” - 使用单选按钮选择输出类型：

  • 文件 - 将屏幕截图保存到指定位置的文件。 默认选项。
  • “图像” - 将屏幕截图保存到指定的图像。
  • 剪贴板 - 将屏幕截图另存为剪贴板中的图像，以备后用。
• “文件名” - 保存指定用户界面元素屏幕截图的文件的名称。 单击“浏览文件” ，然后浏览到用于保存屏幕截图的文件夹，并指定要使用的文件名和扩展名。

• 自动增量 - 选择在保存屏幕截图时附加到文件名的内容，以防文件名冲突。 例如，如果已存在与您保存的文件同名的文件，则选择 “索引” 会保留文件名，为每个屏幕截图创建一个新文件，并为每个屏幕截图连续添加一个索引号。

  • 无（覆盖） - 如果已存在同名文件，请将其替换。
  • 索引 - 在文件名中添加一个数字，例如 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
  • 可见性检查 - 检查用户界面元素是否可见。 您可以从下拉菜单中选择以下三个选项之一：
    • “无 ”- 不检查可见性。
    • 交互式（用于模糊选取器） - 默认选项。 检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
    • 完全可见 - 检查用户界面元素是否可见。
  • 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一：
    • 无- 不等待目标变为就绪状态。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
  • 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。

输入/输出元素

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

其他

• “私有” - 如果选中，则不再以“Verbose”级别记录变量和参数的值。 此字段仅支持 Boolean (True和 False) 值。 默认值为 False。

输出

• “已保存的文件路径 ” - 用于保存屏幕截图的文件的完整路径，包括附加的后缀（如果适用）。 这也指定了“ 自动增量 ”属性将索引的屏幕截图文件保存在何处。
• “已保存的图像 ” - 将屏幕截图另存为“ 图像”；将“输出”设置为 image时使用。

跨平台配置

• “在作用域内工作” - 选择呈现要自动化的网页应用程序的浏览器选项卡。

• 在屏幕上指定目标 - 指定要用作目标的用户界面元素。

  指定目标后，选择加号按钮以访问以下选项：

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。

• 屏幕截图容器 - 在“ 整个页面” 和“ 元素 ”之间进行选择，以截取整个页面或单个元素的屏幕截图。 默认选项为“ 整个页面”。

其他选项

计时

• “在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “延迟 时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。 默认值为 0.3 秒。 在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。 默认值为 30 秒。

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

选项

• “文件名 ” - 保存指定用户界面元素屏幕截图的文件的名称。
• “自动递增” - 定义在文件名冲突的情况下要附加到文件名的内容。 从下拉菜单中选择一个选项：
  • 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)的文件。
  • 索引 - 如果已存在一个或多个与模式 Filename (XX) 匹配的文件，则系统会创建一个名为 Filename (N+1)的新文件，其中 N 是现有文件中的最大索引。
  • 无（覆盖） - 文件名将与指定的完全相同，如果已存在另一个同名文件，则该文件名将被覆盖。 这是默认选项。

输入/输出

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