活动
最新
False
横幅背景图像
用户界面自动化活动
上次更新日期 2024年2月26日

截取屏幕截图

UiPath.UIAutomationNext.Activities.NTakeScreenshot

描述

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

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

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

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

    指定目标后,选择“ 菜单 按钮以访问以下选项:

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

    • 文件 - 将屏幕截图保存到指定位置的文件。 默认选项。
    • “图像” - 将屏幕截图保存到指定的图像。
    • 剪贴板 - 将屏幕截图另存为剪贴板中的图像,以备后用。
  • 文件名” - 保存指定用户界面元素屏幕截图的文件的名称。 单击“浏览文件”docs image ,然后浏览到用于保存屏幕截图的文件夹,并指定要使用的文件名和扩展名。
  • 自动增量 - 选择在保存屏幕截图时附加到文件名的内容,以防文件名冲突。 例如,如果已存在与您保存的文件同名的文件,则选择 “索引” 会保留文件名,为每个屏幕截图创建一个新文件,并为每个屏幕截图连续添加一个索引号。

    • 无(覆盖) - 如果已存在同名文件,请将其替换。
    • 索引 - 在文件名中添加一个数字,例如 screenshot (1).png
    • YYYY.MM.DD at HH.MM.SS - 在文件名中添加截取屏幕截图的日期和时间,例如 screenshot 2020.06.22 at 10:22:32
属性面板

常见

  • “出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持 Boolean 值(TrueFalse)。 默认值为 False。 因此,如果该字段为空且活动引发错误,系统将停止执行项目。 如果该值设置为 True,则无论出现何种错误,系统都将继续执行项目。
  • 延迟 时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间(以秒为单位)。 默认值为 0.3 秒。 在活动之间添加延迟可确保一个活动有足够的时间完成,然后再开始下一个活动。

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

  • 显示名称- 设计器面板中活动的显示名称指定目标时,系统会自动生成显示名称。

  • 超时 ”- 指定等待时间(以秒为单位),如果超出该时间活动未执行,就会引发错误。 您还可以从下拉菜单中选择预定义的值: 10 (s)20 (s)30 (s)。 默认值为 30 秒。

输入

  • “自动递增 ” - 请参阅“设计器”面板中的“ 自动递增 ”。
  • 文件名 ” - 在“设计器”面板中查看“ 文件名 ”。
  • 目标 ” - 目标元素。 必须设置目标元素。 在屏幕上指定之前,此字段设置为 (null)。 指定目标后,将显示与指定元素相关的所有属性。
    • CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
    • 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
    • 模糊选取器 ” - 模糊选取器的参数。
    • 原生文本 - 用于标识用户界面元素的文本。
    • 响应式网站 - 启用响应式网站布局。
    • 严格选取器 ” - 为用户界面元素生成的“严格选取器”。
    • 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合:
      • 精确选取器
      • 模糊选取器
      • 图像
      • 原生文本
      • Computer Vision
    • 可见性检查 - 检查用户界面元素是否可见。 您可以从下拉菜单中选择以下三个选项之一:
      • ”- 不检查可见性。
      • 交互式(用于模糊选取器) - 默认选项。 检查元素是否可能可见,忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时,此检查非常有用。
      • 完全可见 - 检查用户界面元素是否可见。
    • 等待页面加载 - 在执行 Actions之前,等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一:
      • - 不等待目标变为就绪状态。
      • “交互式”– 等待直到加载了应用程序的一部分。
      • “完整”– 等待整个应用程序被加载。
    • 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。

输入/输出元素

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

其他

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

输出

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

跨平台配置

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

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

    • “在屏幕上指定目标”- 再次指定目标。
    • 编辑目标 - 打开选择模式以配置目标。
  • 屏幕截图容器 - 在“ 整个页面” 和“ 元素 ”之间进行选择,以截取整个页面或单个元素的屏幕截图。 默认选项为“ 整个页面”

其他选项

计时

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

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

  • 超时 ”- 指定等待时间(以秒为单位),如果超出该时间活动未执行,就会引发错误。 您还可以从下拉菜单中选择预定义的值: 10 (s)20 (s)30 (s)。 默认值为 30 秒。

  • “出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持 Boolean 值(TrueFalse)。 默认值为 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 对象中,该对象可进一步用于通过其他活动定位同一元素。
  • 描述
  • 项目兼容性
  • Windows - 旧版 Windows 配置
  • 跨平台配置

此页面是否有帮助?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath 白色徽标
信任与安全
© 2005-2024 UiPath. All rights reserved.