activities
latest
false
重要 :
请注意此内容已使用机器翻译进行了部分本地化。
用户界面自动化活动
Last updated 2024年10月28日

悬停在图像上方

UiPath.Core.Activities.HoverImage

搜索用户界面元素中的图像,并悬停在该图像上方。

属性

输入
  • Image.Image - 待搜索的现有图像。此字段仅支持图像变量。
  • Image.Accuracy - 介于 0 到 1 的一种度量单位,表示您正在搜索的图像与要查找的图像之间的最低相似度。当要查找的图像与您正在搜索的图像略有不同时,此方法较为适用。默认值为 0.8。
  • Image.Profile - 用于更改要使用的图像检测算法。基础版是经典算法,速度和资源成本均适中。增强版可提供更精确的结果,但资源成本较高。默认情况下,该字段设为基础版
  • “目标选择器” - 执行活动时用于查找特定用户界面元素的文本属性。 它实际上是一个 XML 片段,用于指定您要查找的 GUI 元素及其某些父元素的属性。
  • Target.TimeoutMS - 指定在引发 SelectorNotFoundException 错误之前等待活动运行的时间(以毫秒为单位)。 默认值为 30000 毫秒 (30 秒)。
  • Target.WaitForReady - 在执行操作之前,请等待目标就绪。 提供以下选项:

    • “无”- 在执行操作之前,系统不会等待显示除目标用户界面元素之外的任何内容。例如,如果希望只从网页检索文本或单击特定按钮,则可以使用此选项,而不必等待用户界面元素全部加载。请注意,如果按钮依赖于尚未加载的元素(例如脚本),则可能会产生不良后果。
    • “交互/完成” - 待目标应用程序中的所有用户界面元素全部显示之后,再实际执行操作。

      为了评估应用程序处于“交互”状态还是“完成”状态,系统将验证以下标签:

    • “桌面应用程序”- 系统会发出一条“wm_null”消息,以检查是否存在“<wnd>”、“<ctrl>”、“<java>”或“<uia>”标签。如存在,则执行活动。
    • 网页应用程序:
    1. Internet Explorer - <webctrl> 标签用于检查 HTML 文档的就绪状态是否设为完成。此外,必须将忙碌状态设置为“False”。
    2. 其他 - <webctrl> 标签用于检查 HTML 文档的“就绪”状态是否为“完成”
    • “SAP 应用程序”- 首先验证是否存在“<wnd>”标签,然后使用 SAP 特定 API 来检测会话是否繁忙。
  • “目标.元素” - 使用另一个活动返回的用户界面元素变量。 此属性不能与“选取器”属性一起使用。 此字段仅支持用户界面元素变量。
  • Target.ClippingRegion - 沿以下方向定义相对于用户界面元素的剪切矩形(以像素为单位):左、上、右、下。 它支持正数和负数。
选项
  • 发送窗口消息- 如果选中该复选框,则系统会向目标应用程序发送一条特定消息以执行悬停。这种输入方法速度更快,且可在后台工作。默认情况下,该复选框处于未选中状态。如果未选中该复选框,则默认方法通过使用硬件驱动程序执行悬停。默认方法速度最慢,且不能在后台工作,但可兼容所有桌面应用程序。
  • “键修饰符” - 用于添加键修饰符。 提供以下选项:Alt、Ctrl、Shift 和 Win。

    注意:修饰键不能与“发送窗口消息”选项一起使用。执行包含具有此选项组合的活动的工作流时,不会引发错误。
  • CursorPosition.OffsetX - 根据“位置”字段中的选定选项对光标位置进行的水平位移。
  • CursorPosition.OffsetY - 根据“位置”字段中的选定选项对光标位置进行的垂直位移。
  • CursorPosition.Position - 描述光标的起始点,向其添加“偏移 X”和“偏移 Y”属性的偏移量。提供以下选项:“左上”、“右上”、“左下”、“右下”和“中间”。默认选项为“中间”。
常见
  • “显示名称”- 活动的显示名称。
  • “延迟MS” - 执行活动后的延迟时间(以毫秒为单位)。 默认时间为 300 毫秒。
  • “延迟 之前” - 活动开始执行任何操作之前的延迟时间(以毫秒为单位)。 默认时间为 200 毫秒。
  • “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此,如果该字段为空且活动引发错误,系统将停止执行项目。如果该值设为“True”,则无论出现何种错误,系统都将继续执行项目。

    注意:如果 Try Catch 异常处理中包含该活动且出错时继续属性的值为 True,则系统在执行项目时不会捕获任何错误。
其他
  • “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

使用“悬停图像”活动的示例

悬停图像 ”活动用于在用户界面元素内搜索图像并将鼠标悬停在其上。

为了举例说明如何使用此活动,我们创建了一个示例,该示例将打开浏览器,将鼠标悬停在图像上,启动操作并显示该操作的相关结果。

此自动化流程的构建方法如下:

  1. 打开 Studio ,创建一个新“流程”
  2. 序列活动拖动至工作流设计器。
  3. 将“打开浏览器”活动拖动到“序列”容器中。

    • 属性面板中,从浏览器类型下拉列表中选择 IE 选项。
    • URL字段中添加表达式 "https://www.goodreads.com/book/show/7144.Crime_and_Punishment"
    • 选中新会话选项的复选框。此选项将打开所选浏览器的新会话。
  4. 悬停图像活动拖动到打开浏览器活动的正文容器内。

    • 打开之前在“打开浏览器”活动中添加的网址。
    • 悬停图像活动中选择单击以打开选项菜单按钮,然后单击从屏幕抓取选项。选择所需的图像。
  5. 将“单击图像”活动拖动到“悬停图像”活动下方。

    • 属性面板中,从单击类型下拉列表中选择CLICK_SINGLE选项。
    • 鼠标按键下拉列表中选择BTN_LEFT选项。
    • 目标下拉列表中选择Target选项。
    • 选取器字段中添加表达式 "<html title='*' /><webctrl aaname='Other editions' parentid='imagecol' tag='A' />"
    • 等待就绪下拉列表中选择 INTERACTIVE 选项。
  6. 运行流程。机器人将打开新浏览器,访问网站,将鼠标悬停在所选图像上,然后单击“其他版本”按钮。


  • 属性
  • 使用“悬停图像”活动的示例

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。