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

单击

UiPath.Core.Activities.Click

单击指定的用户界面元素。

重要提示:

双击”活动与“单击 活动具有相同的功能,唯一的区别在于,“ 双击”活动的“单击 类型”默认设置为 CLICK_DOUBLE,而“ 单击 ”活动的“单击 类型”默认设置为 CLICK_SINGLE

属性

常见
  • “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 FALSE。因此,如果该字段为空且活动引发错误,系统将停止执行项目。如果该值设为“True”,则无论出现何种错误,系统都将继续执行项目。
    注意:如果 Try Catch 异常处理中包含该活动且出错时继续属性的值为 True,则系统在执行项目时不会捕获任何错误。
  • 在此之后延迟 - 执行活动之后的延迟时间(以毫秒为单位)。默认时长为 300 毫秒。
  • “延迟 之前” - 活动开始执行任何操作之前的延迟时间(以毫秒为单位)。 默认时间为 200 毫秒。
  • “显示名称”- 活动的显示名称。
输入
  • 单击 类型” - 指定模拟单击事件时使用的鼠标单击类型(单击、双击、向上、向下)。 默认情况下,选择单击。
  • 鼠标 按钮” - 用于单击操作的鼠标按钮(左、右、中)。 默认情况下,鼠标左键处于选中状态。
  • Target.ClippingRegion - 沿以下方向定义相对于用户界面元素的剪切矩形(以像素为单位):左、上、右、下。 它支持正数和负数。
  • “目标.元素” - 使用另一个活动返回的用户界面元素变量。 此属性不能与“选取器”属性一起使用。 此字段仅支持用户界面元素变量。
  • “目标选择器” - 执行活动时用于查找特定用户界面元素的文本属性。 它实际上是一个 XML 片段,用于指定您要查找的 GUI 元素及其某些父元素的属性。
  • Target.Timeout(以毫秒为单位)- 指定最长等待时间(以毫秒为单位),如果超出该时间后活动并未运行,系统便会抛出 SelectorNotFoundException 错误。默认值为 30000 毫秒(30 秒)。
  • Target.WaitForReady - 在执行操作之前,请等待目标就绪。 提供以下选项:
    • “无”- 在执行操作之前,系统不会等待显示除目标用户界面元素之外的任何内容。例如,如果希望只从网页检索文本或单击特定按钮,则可以使用此选项,而不必等待用户界面元素全部加载。请注意,如果按钮依赖于尚未加载的元素(例如脚本),则可能会产生不良后果。
    • “交互式”– 等待直到加载了应用程序的一部分。
    • “完整”– 等待整个应用程序被加载。
其他
  • “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
选项
  • “如果禁用则更改”- 如果启用,则即使禁用了指定的用户界面元素,也会执行该操作。
  • “光标移动类型”- 指定鼠标光标执行的运动类型。有两个可用选项:
    • 即时 ” - 光标跳转到目标位置。 默认情况下,“ 即时 ”处于选中状态。
    • 平滑 ” - 光标以增量方式移动。 如果启用了“发送窗口消息”或“ 模拟 单击”,则无效。
  • CursorPosition.OffsetX - 根据“位置”字段中的选定选项对光标位置进行的水平位移。
  • CursorPosition.OffsetY - 根据“位置”字段中的选定选项对光标位置进行的垂直位移。
  • CursorPosition.Position - 描述光标的起始点,向其添加“偏移 X”和“偏移 Y”属性的偏移量。提供以下选项:“左上”、“右上”、“左下”、“右下”和“中间”。默认选项为“中间”。
  • “键修饰符” - 用于添加键修饰符。 提供以下选项:“ ”、“ Alt”、“ Ctrl”、“ Shift”和“ Win”。 默认选项为“ ”。
    备注: 修饰键不能与模拟单击发送窗口消息选项一起使用。执行包含具有这些选项组合之一的活动的工作流时,不会引发错误。
  • “发送窗口消息” - 如果选中,则通过向目标应用程序发送特定消息来执行单击。 此输入法可以在后台运行,与大多数桌面应用程序兼容,但并不是速度最快的方法。 默认情况下,未选中此复选框。 如果此复选框和“ 模拟 单击” 复选框均未选中,则默认方法将使用硬件驱动程序模拟单击。 默认方法最慢,无法在后台运行,但与所有桌面应用程序兼容。
  • 模拟 单击” - 如果选中,则使用目标应用程序的技术模拟单击。 此输入法是三种输入法中速度最快的一种,可在后台运行。 默认情况下,未选中此复选框。 如果此复选框和“ 发送窗口消息” 复选框均未选中,则默认方法是使用硬件驱动程序执行单击。 默认方法最慢,无法在后台运行,但与所有桌面应用程序兼容。 如果选择此属性,则建议在执行之前检查目标用户界面元素的状态。 可在此 页面上找到更多详细信息。
    备注:模拟 单击”只能与“ CLICK_SINGLE”“BTN_LEFT” 输入类型一起使用。 否则,执行工作流时将引发错误。
  • “取消阻止输入” - 当“ 单击 ”触发模态对话框或其他阻止用户界面时,应使用此选项。 仅与“ 模拟单击”一起使用。 此字段仅支持 Boolean 值。 此选项的默认值为 False

使用“单击”活动的示例

可以在此查看包含多个活动的示例,了解如何使用 单击 活动。

“双击”活动使用示例

可以在此查看包含多个活动的示例,了解如何使用“ 双击 ”活动。

此页面有帮助吗?

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