- 概述
- 用户界面自动化
- 关于“用户界面自动化”活动包
- 通过用户界面自动化实现自动化的应用程序和技术
- 项目兼容性
- UI-ANA-016 - 拉取打开浏览器 URL
- UI-ANA-017 - 出错时继续 True
- UI-ANA-018 - 列出 OCR/图像活动
- UI-DBP-006 - 容器使用情况
- UI-DBP-013 - Excel 自动化误用
- UI-DBP-030 - 选取器中的禁止变量使用情况
- UI-DBP-031 - 活动验证
- UI-PRR-001 - 模拟单击
- UI-PRR-002 - 模拟键入
- UI-PRR-003 - 打开应用程序误用
- UI-PRR-004 - 硬编码延迟
- UI-REL-001 - 选取器中的大 IDX
- UI-SEC-004 - 选取器电子邮件数据
- UI-SEC-010 - 应用程序/Url 限制
- UI-USG-011 - 不允许的属性
- UX-SEC-010 - 应用程序/Url 限制
- UX-DBP-029 - 使用不安全的密码
- UI-PST-001 - 项目设置中的审核日志级别
- UiPath 浏览器迁移工具
- 剪切区域
- 计算机视觉录制器
- 活动索引
- 激活
- 锚点基准
- 附加浏览器
- 附加窗口
- 阻止用户输入
- 标注
- 选中
- 单击
- 单击图像
- 单击图像触发器
- 单击 OCR 文本
- 单击文本
- 单击触发器
- 关闭应用程序
- 关闭选项卡
- 关闭窗口
- 上下文感知锚点
- 复制选定文本
- 元素属性更改触发器
- 存在元素
- 元素作用域
- 元素状态更改触发器
- 导出用户界面树
- 提取结构化数据
- 查找子元素
- 查找元素
- 查找图像
- 查找图像匹配项
- 查找 OCR 文本位置
- 查找相对元素
- 查找文本位置
- 获取活动窗口
- 获取上级
- 获取属性
- 获取事件信息
- 从剪贴板获取
- 获取全文
- 获取 OCR 文本
- 获取密码
- 获取位置
- 获取源元素
- 获取文本
- 获取可见文本
- 返回
- 前往
- 转至主页
- Google Cloud Vision OCR
- 隐藏窗口
- 高亮显示
- 热键触发器
- 悬停
- 悬停在图像上方
- 悬停在 OCR 文本上方
- 悬停文本
- 存在图像
- 在屏幕上指定
- 注入 .NET 代码
- 插入 Js 脚本
- 调用 ActiveX 方法
- 按键触发器
- 加载图像
- 最大化窗口
- Microsoft Azure 计算机视觉 OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- 最小化窗口
- 监控事件
- 鼠标触发器
- 移动窗口
- 导航至
- 存在 OCR 文本
- 在元素出现时
- 在元素消失时
- 在图像出现时
- 在图像消失时
- 打开应用程序
- 打开浏览器
- 刷新浏览器
- 重播用户事件
- 还原窗口
- 保存图像
- 选择项目
- 选择多个项目
- 发送热键
- 设置剪切区域
- 设置焦点
- 设置文本
- 设置为剪贴板
- 设置网页属性
- 显示窗口
- 启动进程
- 系统触发器
- 截取屏幕截图
- Tesseract OCR
- 存在文本
- 工具提示
- 键入
- 输入安全文本
- 使用前台
- 等待属性
- 等待元素消失
- 等待图像消失
- Computer Vision Local Server
- 移动自动化
- 终端
用户界面自动化活动
单击指定的用户界面元素,例如按钮或链接。 可以配置为使用任何鼠标键,使用双击。
定义
命名空间:UiPath.UIAutomationNext.API.Models
程序集:UiPath.UIAutomationNext.API.Models(位于 UiPath.UIAutomationNext.API.Models dll 中)
重载
| 重载 | 描述 |
|---|---|
Click(String, ClickOptions) | 单击“对象存储库”中由字符串标识的用户界面元素。 |
Click(IElementDescriptor, ClickOptions) | 单击由对象存储库中元素描述符标识的用户界面元素。 |
Click(TargetAnchorableModel, ClickOptions) | 单击目标可锚定模型,该模型表示应用程序中的特定用户界面元素。 |
Click(RuntimeTarget, ClickOptions) | 单击由对象存储库元素的运行时实例标识的用户界面元素。 |
Click(String, NClickType, NMouseButton) | 对对象存储库中由字符串标识的用户界面元素执行单击操作,并指定单击类型和鼠标键。 |
Click(IElementDescriptor, NClickType, NMouseButton) | 单击由对象存储库中元素描述符标识的用户界面元素,并指定单击类型和鼠标键。 |
Click(String, ClickOptions)
单击由字符串表示形式标识的用户界面元素。
Click(
TargetAnchorableModel target,
ClickOptions clickOptions)
Click(
TargetAnchorableModel target,
ClickOptions clickOptions)
target String :指示在对象存储库中捕获且要单击的用户界面元素。
clickOptions ClickOptions :用于自定义单击操作的其他选项:
* `KeyModifiers NKeyModifiers`:
+ `None`
+ `Alt`
+ `Ctrl`
+ `Shift`
+ `Win`
* `ClickType NClickType`:
+ `Single`
+ `Double`
+ `Down`
+ `Up`
For example, to perform a double click you just need to set
the click type to
`NClickType.Double`:
`clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest,
new ClickOptions(){ClickType =
NClickType.Double}.WithVariable("account_number_system1",
"407547"));`.
* `MouseButton NMouseButton`:
+ `Left`
+ `Right`
+ `Middle`
* `CursorMotionType
CursorMotionType`:
+ `Instant` - The cursor jumps to the
destination.
+ `Smooth` - The cursor moves in
increments.
* `InteractionMode
NInteractionMode`:
+ `HardwareEvents` - Simulates the click
by using the hardware driver. This is the slowest API, it
cannot work in the background, but it is compatible with all
desktop apps.
+ `SameAsCard` - Use the same input mode
as the Open or Attach APIs. This is the default
selection.
+ `Simulate` - Simulates the click using
accessibility APIs. Recommended in browser automation, Java
apps, or SAP. More reliable than Hardware Events. Works even
if the target application is not in focus. Please test if
your target application UI element supports this.
+ `DebuggerApi` - Performs actions using
debugger APIs. Works for Chromium elements only. Sends all
text in one go. Works even if the target application is not
in focus. For more details, check out this [page](https://docs.uipath.com/studio/standalone/2023.10/user-guide/chromium-api).
+ `WindowMessages` - Simulates using Win32
messages. Recommended for desktop apps. Usually more
reliable than Hardware Events. Sends all text in one go.
Works even if the target application is not in focus. Before
using this API, please test if your target application UI
element supports this.
* `KeyModifiers NKeyModifiers`:
+ `None`
+ `Alt`
+ `Ctrl`
+ `Shift`
+ `Win`
* `ClickType NClickType`:
+ `Single`
+ `Double`
+ `Down`
+ `Up`
For example, to perform a double click you just need to set
the click type to
`NClickType.Double`:
`clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest,
new ClickOptions(){ClickType =
NClickType.Double}.WithVariable("account_number_system1",
"407547"));`.
* `MouseButton NMouseButton`:
+ `Left`
+ `Right`
+ `Middle`
* `CursorMotionType
CursorMotionType`:
+ `Instant` - The cursor jumps to the
destination.
+ `Smooth` - The cursor moves in
increments.
* `InteractionMode
NInteractionMode`:
+ `HardwareEvents` - Simulates the click
by using the hardware driver. This is the slowest API, it
cannot work in the background, but it is compatible with all
desktop apps.
+ `SameAsCard` - Use the same input mode
as the Open or Attach APIs. This is the default
selection.
+ `Simulate` - Simulates the click using
accessibility APIs. Recommended in browser automation, Java
apps, or SAP. More reliable than Hardware Events. Works even
if the target application is not in focus. Please test if
your target application UI element supports this.
+ `DebuggerApi` - Performs actions using
debugger APIs. Works for Chromium elements only. Sends all
text in one go. Works even if the target application is not
in focus. For more details, check out this [page](https://docs.uipath.com/zh-CN/studio/standalone/2023.10/user-guide/chromium-api).
+ `WindowMessages` - Simulates using Win32
messages. Recommended for desktop apps. Usually more
reliable than Hardware Events. Sends all text in one go.
Works even if the target application is not in focus. Before
using this API, please test if your target application UI
element supports this.
Click(IElementDescriptor, ClickOptions)
单击由对象存储库中元素描述符标识的用户界面元素。
Click(
IElementDescriptor elementDescriptor,
ClickOptions clickOptions)
Click(
IElementDescriptor elementDescriptor,
ClickOptions clickOptions)
elementDescriptor IElementDescriptor :要单击的用户界面元素,由对象存储库中元素的描述符标识。
clickOptions ClickOptions :用于自定义单击操作的其他选项:
* `KeyModifiers NKeyModifiers`:
+ `None`
+ `Alt`
+ `Ctrl`
+ `Shift`
+ `Win`
* `ClickType
NClickType`:
+ `Single`
+ `Double`
+ `Down`
+ `Up`
For example, to perform a double click you just need to set
the click type to
`NClickType.Double`:
`clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest,
new ClickOptions(){ClickType =
NClickType.Double}.WithVariable("account_number_system1",
"407547"));`.
* `MouseButton NMouseButton`:
+ `Left`
+ `Right`
+ `Middle`
* `CursorMotionType
CursorMotionType`:
+ `Instant` - The cursor jumps to the
destination.
+ `Smooth` - The cursor moves in
increments.
* `InteractionMode
NInteractionMode`:
+ `HardwareEvents` - Simulates the click
by using the hardware driver. This is the slowest API, it
cannot work in the background, but it is compatible with all
desktop apps.
+ `SameAsCard` - Use the same input mode
as the Open or Attach APIs. This is the default
selection.
+ `Simulate` - Simulates the click using
accessibility APIs. Recommended in browser automation, Java
apps, or SAP. More reliable than Hardware Events. Works even
if the target application is not in focus. Please test if
your target application UI element supports this.
+ `DebuggerApi` - Performs actions using
debugger APIs. Works for Chromium elements only. Sends all
text in one go. Works even if the target application is not
in focus. For more details, check out this [page](https://docs.uipath.com/studio/standalone/2023.10/user-guide/chromium-api).
+ `WindowMessages` - Simulates using Win32
messages. Recommended for desktop apps. Usually more
reliable than Hardware Events. Sends all text in one go.
Works even if the target application is not in focus. Before
using this API, please test if your target application UI
element supports this.
* `KeyModifiers NKeyModifiers`:
+ `None`
+ `Alt`
+ `Ctrl`
+ `Shift`
+ `Win`
* `ClickType
NClickType`:
+ `Single`
+ `Double`
+ `Down`
+ `Up`
For example, to perform a double click you just need to set
the click type to
`NClickType.Double`:
`clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest,
new ClickOptions(){ClickType =
NClickType.Double}.WithVariable("account_number_system1",
"407547"));`.
* `MouseButton NMouseButton`:
+ `Left`
+ `Right`
+ `Middle`
* `CursorMotionType
CursorMotionType`:
+ `Instant` - The cursor jumps to the
destination.
+ `Smooth` - The cursor moves in
increments.
* `InteractionMode
NInteractionMode`:
+ `HardwareEvents` - Simulates the click
by using the hardware driver. This is the slowest API, it
cannot work in the background, but it is compatible with all
desktop apps.
+ `SameAsCard` - Use the same input mode
as the Open or Attach APIs. This is the default
selection.
+ `Simulate` - Simulates the click using
accessibility APIs. Recommended in browser automation, Java
apps, or SAP. More reliable than Hardware Events. Works even
if the target application is not in focus. Please test if
your target application UI element supports this.
+ `DebuggerApi` - Performs actions using
debugger APIs. Works for Chromium elements only. Sends all
text in one go. Works even if the target application is not
in focus. For more details, check out this [page](https://docs.uipath.com/zh-CN/studio/standalone/2023.10/user-guide/chromium-api).
+ `WindowMessages` - Simulates using Win32
messages. Recommended for desktop apps. Usually more
reliable than Hardware Events. Sends all text in one go.
Works even if the target application is not in focus. Before
using this API, please test if your target application UI
element supports this.
Click(TargetAnchorableModel, ClickOptions)
单击目标可锚定模型,该模型表示应用程序中的特定用户界面元素。
Click(
TargetAnchorableModel target,
ClickOptions clickOptions)
Click(
TargetAnchorableModel target,
ClickOptions clickOptions)
target TargetAnchorableModel :要单击的目标可锚定模型(用户界面元素)。
clickOptions ClickOptions :用于自定义单击操作的其他选项:
* `KeyModifiers NKeyModifiers`:
+ `None`
+ `Alt`
+ `Ctrl`
+ `Shift`
+ `Win`
* `ClickType NClickType`:
+ `Single`
+ `Double`
+ `Down`
+ `Up`
For example, to perform a double click you just need to set
the click type to
`NClickType.Double`:
`clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest,
new ClickOptions(){ClickType =
NClickType.Double}.WithVariable("account_number_system1",
"407547"));`.
* `MouseButton NMouseButton`:
+ `Left`
+ `Right`
+ `Middle`
* `CursorMotionType CursorMotionType`:
+ `Instant` - The cursor jumps to the
destination.
+ `Smooth` - The cursor moves in
increments.
* `InteractionMode NInteractionMode`:
+ `HardwareEvents` - Simulates the click by
using the hardware driver. This is the slowest API, it
cannot work in the background, but it is compatible with all
desktop apps.
+ `SameAsCard` - Use the same input mode as the
Open or Attach APIs. This is the default selection.
+ `Simulate` - Simulates the click using
accessibility APIs. Recommended in browser automation, Java
apps, or SAP. More reliable than Hardware Events. Works even
if the target application is not in focus. Please test if
your target application UI element supports this.
+ `DebuggerApi` - Performs actions using
debugger APIs. Works for Chromium elements only. Sends all
text in one go. Works even if the target application is not
in focus. For more details, check out this [page](https://docs.uipath.com/studio/standalone/2023.10/user-guide/chromium-api).
+ `WindowMessages` - Simulates using Win32
messages. Recommended for desktop apps. Usually more
reliable than Hardware Events. Sends all text in one go.
Works even if the target application is not in focus. Before
using this API, please test if your target application UI
element supports this.
* `KeyModifiers NKeyModifiers`:
+ `None`
+ `Alt`
+ `Ctrl`
+ `Shift`
+ `Win`
* `ClickType NClickType`:
+ `Single`
+ `Double`
+ `Down`
+ `Up`
For example, to perform a double click you just need to set
the click type to
`NClickType.Double`:
`clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest,
new ClickOptions(){ClickType =
NClickType.Double}.WithVariable("account_number_system1",
"407547"));`.
* `MouseButton NMouseButton`:
+ `Left`
+ `Right`
+ `Middle`
* `CursorMotionType CursorMotionType`:
+ `Instant` - The cursor jumps to the
destination.
+ `Smooth` - The cursor moves in
increments.
* `InteractionMode NInteractionMode`:
+ `HardwareEvents` - Simulates the click by
using the hardware driver. This is the slowest API, it
cannot work in the background, but it is compatible with all
desktop apps.
+ `SameAsCard` - Use the same input mode as the
Open or Attach APIs. This is the default selection.
+ `Simulate` - Simulates the click using
accessibility APIs. Recommended in browser automation, Java
apps, or SAP. More reliable than Hardware Events. Works even
if the target application is not in focus. Please test if
your target application UI element supports this.
+ `DebuggerApi` - Performs actions using
debugger APIs. Works for Chromium elements only. Sends all
text in one go. Works even if the target application is not
in focus. For more details, check out this [page](https://docs.uipath.com/zh-CN/studio/standalone/2023.10/user-guide/chromium-api).
+ `WindowMessages` - Simulates using Win32
messages. Recommended for desktop apps. Usually more
reliable than Hardware Events. Sends all text in one go.
Works even if the target application is not in focus. Before
using this API, please test if your target application UI
element supports this.
Click(RuntimeTarget, ClickOptions)
单击由对象存储库元素的运行时实例标识的用户界面元素。
Click(
RuntimeTarget target,
ClickOptions clickOptions)
Click(
RuntimeTarget target,
ClickOptions clickOptions)
target RuntimeTarget :要单击的用户界面元素,由对象存储库元素的运行时实例标识。
clickOptions ClickOptions :用于自定义单击操作的其他选项:
* `KeyModifiers NKeyModifiers`:
+ `None`
+ `Alt`
+ `Ctrl`
+ `Shift`
+ `Win`
* `ClickType
NClickType`:
+ `Single`
+ `Double`
+ `Down`
+ `Up`
For example, to perform a double click you just need to set
the click type to
`NClickType.Double`:
`clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest,
new ClickOptions(){ClickType =
NClickType.Double}.WithVariable("account_number_system1",
"407547"));`.
* `MouseButton NMouseButton`:
+ `Left`
+ `Right`
+ `Middle`
* `CursorMotionType
CursorMotionType`:
+ `Instant` - The cursor jumps to the
destination.
+ `Smooth` - The cursor moves in
increments.
* `InteractionMode
NInteractionMode`:
+ `HardwareEvents` - Simulates the click
by using the hardware driver. This is the slowest API, it
cannot work in the background, but it is compatible with all
desktop apps.
+ `SameAsCard` - Use the same input mode
as the Open or Attach APIs. This is the default
selection.
+ `Simulate` - Simulates the click using
accessibility APIs. Recommended in browser automation, Java
apps, or SAP. More reliable than Hardware Events. Works even
if the target application is not in focus. Please test if
your target application UI element supports this.
+ `DebuggerApi` - Performs actions using
debugger APIs. Works for Chromium elements only. Sends all
text in one go. Works even if the target application is not
in focus. For more details, check out this [page](https://docs.uipath.com/studio/standalone/2023.10/user-guide/chromium-api).
+ `WindowMessages` - Simulates using Win32
messages. Recommended for desktop apps. Usually more
reliable than Hardware Events. Sends all text in one go.
Works even if the target application is not in focus. Before
using this API, please test if your target application UI
element supports this.
* `KeyModifiers NKeyModifiers`:
+ `None`
+ `Alt`
+ `Ctrl`
+ `Shift`
+ `Win`
* `ClickType
NClickType`:
+ `Single`
+ `Double`
+ `Down`
+ `Up`
For example, to perform a double click you just need to set
the click type to
`NClickType.Double`:
`clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest,
new ClickOptions(){ClickType =
NClickType.Double}.WithVariable("account_number_system1",
"407547"));`.
* `MouseButton NMouseButton`:
+ `Left`
+ `Right`
+ `Middle`
* `CursorMotionType
CursorMotionType`:
+ `Instant` - The cursor jumps to the
destination.
+ `Smooth` - The cursor moves in
increments.
* `InteractionMode
NInteractionMode`:
+ `HardwareEvents` - Simulates the click
by using the hardware driver. This is the slowest API, it
cannot work in the background, but it is compatible with all
desktop apps.
+ `SameAsCard` - Use the same input mode
as the Open or Attach APIs. This is the default
selection.
+ `Simulate` - Simulates the click using
accessibility APIs. Recommended in browser automation, Java
apps, or SAP. More reliable than Hardware Events. Works even
if the target application is not in focus. Please test if
your target application UI element supports this.
+ `DebuggerApi` - Performs actions using
debugger APIs. Works for Chromium elements only. Sends all
text in one go. Works even if the target application is not
in focus. For more details, check out this [page](https://docs.uipath.com/zh-CN/studio/standalone/2023.10/user-guide/chromium-api).
+ `WindowMessages` - Simulates using Win32
messages. Recommended for desktop apps. Usually more
reliable than Hardware Events. Sends all text in one go.
Works even if the target application is not in focus. Before
using this API, please test if your target application UI
element supports this.
Click(String, NClickType, NMouseButton)
对由字符串表示或选取器标识的用户界面元素执行单击操作,并指定单击类型和鼠标键。
Click(
string target,
NClickType clickType,
NMouseButton mouseButton)
Click(
string target,
NClickType clickType,
NMouseButton mouseButton)
target String :指示在对象存储库中捕获且要单击的用户界面元素。
clickType NClickType :要执行的单击类型:单击、双击、向下或向上。默认选项为“单击”。:例如,要执行双击,您只需将单击类型设置为NClickType.Double : clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest, new ClickOptions(){ClickType = NClickType.Double}.WithVariable("account_number_system1", "407547")); 。
mouseButton NMouseButton :单击时常用的鼠标键:左(左) 、中(中)或右(右) 。默认选项为“左侧”。
Click(IElementDescriptor, NClickType, NMouseButton)
单击由对象存储库中元素描述符标识的用户界面元素,并指定单击类型和鼠标键。
Click(
IElementDescriptor elementDescriptor,
NClickType clickType,
NMouseButton mouseButton)
Click(
IElementDescriptor elementDescriptor,
NClickType clickType,
NMouseButton mouseButton)
elementDescriptor IElementDescriptor :要单击的用户界面元素,由对象存储库中元素的描述符标识。
clickType NClickType :要执行的单击类型:单击、双击、向下或向上。默认选项为“单击”。:例如,要执行双击,您只需将单击类型设置为NClickType.Double : clientAccountsScreen.Click(Descriptors.ACME_System_3.ClientAccountsScreen.AccountRowTest, new ClickOptions(){ClickType = NClickType.Double}.WithVariable("account_number_system1", "407547")); 。
mouseButton NMouseButton :单击时常用的鼠标键:左(左) 、中(中)或右(右) 。默认选项为“左侧”。