IA-Connect Java
IA-Connect 是一个机器人过程自动化(RPA)平台,可将 RPA 功能从云添加到本地虚拟机,或通过 Citrix 或Microsoft远程桌面(RDS)连接。 这是使用 Java 访问桥(JAB)自动执行 Java 应用程序的模块。
此连接器在以下产品和区域中可用:
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 : - Azure 政府区域 - Azure 中国区域 - 美国国防部(DoD) |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 联系人 | |
|---|---|
| Name | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| 连接器元数据 | |
|---|---|
| 发布者 | Ultima Labs |
| 网站 | https://www.ultima.com/ultima-labs |
| 隐私策略 | https://www.ultima.com/privacy-policy |
| 类别 | IT作;生产力 |
IA-Connect 是一个机器人过程自动化(RPA)平台,可将 RPA 功能从 Power Automate 云流添加到本地虚拟机或通过 Citrix 或Microsoft远程桌面(RDS)连接。 IA-Connect 连接器提供 650 多个作,使你可以直接从 Power Automate 云流自动执行每种类型的本地应用程序。 所有 IA-Connect作都可以直接从 Power Automate Cloud Flow 获取,可在基于云的应用程序与本地应用程序之间轻松集成,从而利用 RPA 进程中现有的 Power Automate 条件、循环、动态内容、表达式和异常处理。 利用 IA-Connect 连接器还提供流运行历史记录的完整执行历史记录和可审核性,同时无需使用单独的应用程序/控制台/工作室来开发 RPA 进程。
先决条件
若要使用任何 IA-Connect 连接器,必须安装 IA-Connect 软件。 这可以免费测试 30 天,之后需要 IA-Connect 许可证。
IA-Connect 软件由两个主要组件组成:
IA-Connect Orchestrator,它是一个可在自己的 Azure 租户中托管的 Azure WebApp。 这会处理 RPA 流到一个或多个本地或基于云的虚拟机的路由和安全性。
IA-Connect 代理和控制器,安装在要自动执行的软件可访问的虚拟机上。 此外,IA-Connect 代理可以在 Citrix 或 Microsoft 远程桌面服务 (RDS) 会话中运行,其中 RPA 命令将虚拟通道传递到远程会话以供执行。 IA-Connect 代理可以从网络共享运行,不需要安装。
可用的 IA-Connect 连接器
可用的 IA-Connect 连接器包括:
- IA-Connect 动态代码
- IA-Connect Java
- IA-Connect 大型机
- office IA-Connect Microsoft
- IA-Connect SAP GUI
- IA-Connect 会话
- IA-Connect UI
- IA-Connect Web 浏览器
如何获取凭据
若要接收许可证并开始 30 天的免费试用,请在我们的网站上提交请求(https://www.ultima.com/IA-Connect/Power-Automate)。
收到试用请求后,我们将通过提供的电子邮件地址与你联系,以帮助设置 IA-Connect 软件并提供试用许可证。 这是一个功能齐全的试用版,可让你在试用期内在所有 8 个 IA-Connect 连接器中测试所有 650 个作中的任意一个。
连接器入门
提交 IA-Connect 的试用请求后,你将能够下载包含 IA-Connect 软件和涵盖安装和设置的文档的 ZIP 文件。 我们还将与你联系,根据需要通过安装过程提供支持和指导。
Support
在试用期内,可以联系 Ultima Labs (IAConnect@ultima.com)获取支持和帮助。
购买 IA-Connect 许可证后,将收到支持令牌,这些令牌可以兑换为来自 Ultima 的英国技术服务中心(TSC)的定制培训或支持。
已知问题、常见错误和常见问题解答
我们的知识库包含许多文章,这些文章涵盖了任何已知问题、使用 IA-Connect 连接器和常见问题时可能发生的常见错误。 可在 IA-Connect https://support.ultima.com/ultimalabs 试用期间以及购买 IA-Connect 许可证时访问这些资源的帐户访问。
正在创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| API 密钥 | securestring | 此 API 的 API 密钥 | True |
| IA-Connect Orchestrator 地址 | 字符串 | 指定不带 HTTP(S) 组件的 IA-Connect 业务流程协调程序地址 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| Focus Java 元素 |
聚焦一个 Java 元素,该元素使其成为键盘焦点的活动元素,并且根据应用程序,可能会将元素窗口引入前台。 |
| Java 元素中的全局输入密码 |
将鼠标移动到 Java 元素的中心,将鼠标焦点放在它、左键和按下键。 通常用于不接受本机 UIA 输入方法的密码输入。 |
| Java 元素是否处理相同 |
比较 Java 元素的两个 Java 元素句柄,以查看它们是否表示相同的 Java 对象。 如果已标识元素并检索到其父元素的句柄,则这非常有用。 |
| Java 元素是否存在 |
报告 Java 元素是否存在并返回一些基本元素属性。 |
| Java 桌面元素是否存在 |
报告 Java 桌面元素是否存在并提供一些基本元素属性。 |
| 从元素句柄获取 Java 角色 CSV |
以 CSV 形式返回指定元素句柄下方的元素角色树。 此作仅用于开发目的,并提供应用程序的元素概述,这些元素可用于可视化应用程序结构和优化元素搜索。 |
| 从元素搜索获取 Java 角色 CSV |
执行 Java 元素搜索,并将搜索的元素的详细信息(最多输出到找到元素的点)作为 CSV。 此作仅用于开发目的,并提供应用程序的元素概述,这些元素可用于可视化应用程序结构和优化元素搜索。 |
| 以列表的形式获取 Java 元素属性 |
返回 Java 元素的属性作为单行列表(单行集合/数据表),而不是单个项,这也许很有用,具体取决于你打算如何使用数据。 |
| 全局中间鼠标单击 Java 元素 |
将鼠标移动到 Java 元素的中心,然后单击中间鼠标按钮。 |
| 全局双鼠标左键单击 Java 元素 |
将鼠标移动到 Java 元素的中心,然后双击鼠标左键。 |
| 全局鼠标单击 Java 表单元格 |
将鼠标移动到 Java 表格单元格的中心,然后单击指定的鼠标按钮。 |
| 全局鼠标右键单击 Java 元素 |
将鼠标移动到 Java 元素的中心,然后单击鼠标右键。 |
| 全局鼠标左键单击 Java 元素 |
将鼠标移动到 Java 元素的中心,然后单击鼠标左键。 |
| 围绕 Java 元素绘制矩形 |
在 Java 元素的外围周围绘制一个矩形,以帮助确定找到的元素是必需的。 矩形在 5 秒后自动删除。 |
| 在 Java 元素中输入密码 |
将密码输入 Java 元素(通常是密码输入字段),替换现有文本。 |
| 在屏幕坐标处为 Java 元素创建句柄 |
通过提供屏幕坐标来创建 Java 元素的句柄。 如果 Java 元素存在于指定坐标处,该作将标识该元素并返回该元素的句柄。 |
| 在屏幕坐标处获取 Java 表单元格 |
如果作为表的子元素的 Java 表单元格存在于指定的坐标处,此作将标识元素及其属性,并选择性地返回表单元格元素的句柄。 |
| 对 Java 元素执行作 |
执行 Java 元素的可访问作。 可以使用“获取 Java 元素的作”作来查询特定元素的这些可访问作。 对于文本元素,一些常见作是按钮的“click”或“select-all”。 |
| 将全局输入文本写入 Java 元素 |
将鼠标移动到 Java 元素的中心,将鼠标焦点放在它、左键和按下键。 通常用于不接受本机 UIA 输入法的文本输入。 |
| 将文本输入 Java 元素 |
将文本输入 Java 元素(通常是文本输入字段),要么替换现有文本,要么将新值插入到特定位置。 |
| 屏幕上可见的 Java 表单元格 |
返回 Java 表元素中的特定表单元格当前是否在屏幕上可见。 |
| 展开 Java 选择元素 |
展开或折叠 Java 元素(通常是菜单/下拉列表项)。 如果项已展开,则不会发生任何作。 |
| 按 Java 元素 |
按 Java 元素(通常是按钮)。 |
| 按名称获取 Java 选择状态 |
通过提供子元素名称返回所选内容(通常是列表或下拉列表中的项)中的子元素的选择状态。 可以使用作“获取 Java 选择元素项”检索所有选择子元素项来检查其名称。 |
| 按名称选择 Java 列表元素 |
选择具有指定名称的列表元素。 这通常用于在下拉菜单/菜单项中选择项。 |
| 按索引获取 Java 选择状态 |
通过提供子元素索引返回所选内容(通常是列表或下拉列表中的项)中的子元素的选择状态。 可以使用作“获取 Java 选择元素项”检索所有选择子元素项来检查其索引。 |
| 按索引选择 Java 列表元素 |
选择与指定索引匹配的列表元素。 这通常用于在下拉菜单/菜单项中选择项。 |
| 断开与 Java 访问网桥的连接 |
关闭任何运行 IA-Connect Java 子系统(IA-JavaAccessBridge)。 |
| 是 Java 窗口 |
返回 UIA 窗口是否为 Java 元素。 |
| 检查 Java 元素 |
将元素(通常是复选框或单选框)的状态设置为选中或未选中。 |
| 等待 Java 元素 |
等待 Java 元素(通常是窗口内的单个元素(如按钮或文本输入区域)存在。 |
| 等待 Java 元素不存在 |
等待 Java 元素(通常是窗口内的单个元素(如按钮或文本输入区域)不再存在。 |
| 等待 Java 桌面元素 |
等待 Java 桌面元素(通常是窗口)存在。 |
| 等待 Java 桌面元素不存在 |
等待 Java 桌面元素(通常是窗口)不再存在。 |
| 获取 Java 元素值 |
返回元素的值。 值通常与文本输入区域相关联,但许多元素可以具有此属性。 |
| 获取 Java 元素属性 |
返回 Java 元素的所有 Java 属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。 |
| 获取 Java 元素文本值 |
返回 Java 元素的文本值。 文本值通常与文本元素相关联,但许多元素可以具有此属性。 |
| 获取 Java 元素的作 |
返回 Java 元素的可访问作。 然后,可以使用作名称作为作“对 Java 元素执行作”的作(例如“click”或“select-all”)的输入,对元素执行这些可访问作。 |
| 获取 Java 元素的可见边界矩形 |
检索 Java 元素的可见边界。 通常,Java Access Bridge 将返回元素的虚拟位置值,无论该元素在屏幕上是否可见,这些虚拟值都由“获取 Java 元素属性”作提供。 对于较大的元素(例如可滚动的表元素),因为这些元素可能并不总是在屏幕上可见,此作将返回元素当前可见区域的坐标。 |
| 获取 Java 子元素属性 |
返回由索引指定的特定 Java 子元素的所有属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。 |
| 获取 Java 桌面元素 |
返回桌面上的 Java 应用程序窗口和对话框的列表。 必须首先连接到 Java 访问桥。 |
| 获取 Java 父元素属性 |
返回 Java 元素的父元素的属性。 此作将仅返回直接父元素的属性,并且不会搜索元素树的整个高度。 |
| 获取 Java 表内容 |
返回 Java 表元素的内容。 这是包含行、列、标题和单元格(即表)的元素。 |
| 获取 Java 表单元格属性 |
返回 Java 表元素中指定单元格的属性和内容。 这是包含行、列、标题和单元格(即表)的元素。 可以选择性地指定是否通过枚举视区来确定单元格当前在屏幕上是否可见,以及该单元格是否为坐标。 视区元素通常包含表(例如它是表的父元素),并表示表的可见区域。 |
| 获取 Java 表属性 |
返回 Java 表元素的属性。 这是包含行、列、标题和单元格(即表)的元素。 可以选择通过枚举视区来确定表的哪些组件当前在屏幕上可见。 视区元素通常包含表(例如它是表的父元素),并表示表的可见区域。 |
| 获取 Java 选择元素项 |
返回在指定 Java 选择元素下找到的所有子选择元素项。 可以选择通过循环选择、选择列表中的每个单独选项或读取所选内容的子元素的标签来检索选择元素选项。 如果选择通过读取所选内容的子元素的标签来检索选择元素选项,则可能需要先通过将“Expand first”参数作为“True”来展开所选内容,然后还可以选择关闭所选内容,同时提供“Collapse after”参数作为“True”。 |
| 获取 UIA 元素的 Java 属性 |
返回 UIA 元素的所有 Java 属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。 |
| 获取 Windows 访问网桥信息 |
返回有关特定 Java VM ID(包括 Java 和 Windows DLL 版本)的 Windows 访问桥(WAB)的信息。 Java VM ID 可以作为“获取 Java 元素属性”作的输出获取。 |
| 获取 Windows 访问网桥连接状态 |
返回 IA-Connect 代理与 Windows 访问网桥(WAB)之间的连接的当前状态。 如果 IA-Connect 代理连接到 WAB,则相关详细信息将作为输出返回。 |
| 获取多个 Java 父元素属性 |
返回 Java 元素的所有父元素的属性。 如果“要处理的最大父级”参数设置得足够高,此作将搜索返回所有父属性的元素树的整个高度。 |
| 获取所有 Java 子元素属性 |
返回所有 Java 子元素的所有属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。 |
| 连接到 Java 访问网桥 |
启动 IA-Connect Java 子系统(IA-JavaAccessBridge),并将其连接到指定的 Java 访问桥 DLL(或留空搜索一个)。 必须先执行此步骤,然后才能自动执行 Java 应用程序。 此作还启用必须在运行任何 Java 应用程序之前启用的 Java 访问桥。 |
| 重置所有 Java 元素句柄 |
重置当前由 IA-Connect 存储的所有 Java 元素句柄,如果已识别大量元素并存储了大量元素句柄,这非常有用。 在元素句柄数非常高(100,000+)的情况下,此作还可用于释放 RAM 使用情况。 |
Focus Java 元素
聚焦一个 Java 元素,该元素使其成为键盘焦点的活动元素,并且根据应用程序,可能会将元素窗口引入前台。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
Java 元素中的全局输入密码
将鼠标移动到 Java 元素的中心,将鼠标焦点放在它、左键和按下键。 通常用于不接受本机 UIA 输入方法的密码输入。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
Focus 元素首先
|
FocusElement | boolean |
是否应 IA-Connect 尝试在全局单击之前聚焦元素? |
|
|
全局鼠标左键单击元素
|
GlobalMouseClickOnElement | boolean |
在输入文本之前,是否应在元素坐标(以聚焦元素)处执行全局鼠标单击? |
|
|
使用双击删除鼠标替换现有值
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
是否应通过双击鼠标(突出显示它),然后删除来替换任何现有值? |
|
|
使用 CTRL-A delete 替换现有值
|
ReplaceExistingValueUsingCTRLADelete | boolean |
是否应按 Ctrl-A 替换任何现有值(要突出显示所有值),然后删除? 某些元素可能不支持使用 Ctrl-A 突出显示,在这种情况下,应尝试“使用双击删除替换现有值”的替代选项。 |
|
|
输入密码
|
PasswordToInput | True | password |
全局输入的密码值。 |
|
使用发送密钥事件
|
SendKeyEvents | boolean |
如果设置为 true,则将使用将模拟击键发送到作系统的较低级别的 API。 如果设置为 false,则会改用将击键发送到焦点元素的更高级别的 API。 |
|
|
密钥间隔(以毫秒为单位)
|
KeyIntervalInMilliseconds | integer |
每个按键之间的毫秒数。 |
|
|
双击间隔(以毫秒为单位)
|
DoubleClickIntervalInMilliseconds | integer |
如果参数“使用双击删除替换现有值”设置为 true,则每次单击之间的毫秒数。 |
|
|
不解释符号
|
DontInterpretSymbols | boolean |
“输入密码”中的符号是否不应解释为特殊键(例如+ 用于 Shift、^ for Ctrl)? 如果尝试输入实际符号,则应将其设置为 true。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
Java 元素是否处理相同
比较 Java 元素的两个 Java 元素句柄,以查看它们是否表示相同的 Java 对象。 如果已标识元素并检索到其父元素的句柄,则这非常有用。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
元素 1 JAB 句柄
|
Element1JABHandle | True | integer |
要比较的第一个元素句柄。 |
|
元素 2 JAB 句柄
|
Element2JABHandle | True | integer |
要比较的第二个元素句柄。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
同一对象
|
SameObject | boolean |
如果两个元素句柄都用于同一 Java 对象,则返回 true;如果元素句柄适用于不同的 Java 对象,则返回 false。 |
Java 元素是否存在
报告 Java 元素是否存在并返回一些基本元素属性。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果元素存在,则返回 true;否则返回 false。 |
|
元素 JAB 句柄
|
ElementJABHandle | integer |
如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。 |
|
元素名称
|
ElementName | string |
定位元素的 Java 名称。 |
|
元素说明
|
ElementDescription | string |
定位元素的 Java 说明(如果有)。 |
|
元素角色
|
ElementRole | string |
定位元素的 Java 角色(例如框架或面板)(如果有)。 |
Java 桌面元素是否存在
报告 Java 桌面元素是否存在并提供一些基本元素属性。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
搜索 UIA 元素名称
|
SearchUIAElementName | string |
要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索 UIA 元素类名
|
SearchUIAElementClassName | string |
要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索 UIA 元素本地化控件类型
|
SearchUIAElementLocalizedControlType | string |
要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索进程 ID
|
SearchProcessID | integer |
正在运行的进程的进程 ID。 这可以作为“运行进程”作的输出进行检索。 |
|
|
搜索子元素
|
SearchChildElements | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
包括子进程
|
IncludeChildProcesses | boolean |
如果设置为 true 并且指定了“搜索进程 ID”,则搜索中将包含该进程 ID 的子进程。 这通常适用于 Java,因为启动器 EXE 通常会运行子级“Java(w).exe”进程。 如果设置为 false,则仅返回与确切的“搜索进程 ID”匹配的进程。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果元素存在,则返回 true;否则返回 false。 |
|
元素 JAB 句柄
|
ElementJABHandle | integer |
如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。 |
|
元素名称
|
ElementName | string |
定位元素的 Java 名称。 |
|
元素说明
|
ElementDescription | string |
定位元素的 Java 说明(如果有)。 |
|
元素角色
|
ElementRole | string |
定位元素的 Java 角色(例如框架或面板)(如果有)。 |
从元素句柄获取 Java 角色 CSV
以 CSV 形式返回指定元素句柄下方的元素角色树。 此作仅用于开发目的,并提供应用程序的元素概述,这些元素可用于可视化应用程序结构和优化元素搜索。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
CSV 中的缩进角色
|
IndentRoleInCSV | boolean |
CSV 输出中的子元素角色是否应缩进? 这有助于更好地可视化 Java 元素树中的父关系和子关系。 默认情况下,此值设置为“True”。 |
|
|
在 CSV 中包含说明
|
IncludeDescriptionInCSV | boolean |
元素说明是否应包含在 CSV 输出中? 默认情况下,此值设置为“True”。 |
|
|
在 CSV 中包含维度
|
IncludeDimensionsInCSV | boolean |
元素维度(高度、宽度和边界边缘)是否应包含在 CSV 输出中? 默认情况下,此值设置为“True”。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
找到的元素
|
ElementFound | boolean |
如果找到输入句柄指定的元素,则返回 true;否则返回 false。 |
|
搜索的元素数
|
ElementsSearched | integer |
在父元素下搜索的元素数。 |
|
角色 CSV
|
RoleCSV | string |
包含父元素下找到的每个元素的角色的 CSV 输出。 |
从元素搜索获取 Java 角色 CSV
执行 Java 元素搜索,并将搜索的元素的详细信息(最多输出到找到元素的点)作为 CSV。 此作仅用于开发目的,并提供应用程序的元素概述,这些元素可用于可视化应用程序结构和优化元素搜索。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
CSV 中的缩进角色
|
IndentRoleInCSV | boolean |
CSV 输出中的子元素角色是否应缩进? 这有助于更好地可视化 Java 元素树中的父关系和子关系。 默认情况下,此值设置为“True”。 |
|
|
在 CSV 中包含说明
|
IncludeDescriptionInCSV | boolean |
元素说明是否应包含在 CSV 输出中? 默认情况下,此值设置为“True”。 |
|
|
在 CSV 中包含维度
|
IncludeDimensionsInCSV | boolean |
元素维度(高度、宽度和边界边缘)是否应包含在 CSV 输出中? 默认情况下,此值设置为“True”。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
找到的元素
|
ElementFound | boolean |
如果找到搜索元素,则返回 true;否则返回 false。 |
|
搜索的元素数
|
ElementsSearched | integer |
在找到搜索元素之前在父元素下搜索的元素数。 |
|
角色 CSV
|
RoleCSV | string |
包含搜索中找到的每个元素的角色的 CSV 输出。 |
以列表的形式获取 Java 元素属性
返回 Java 元素的属性作为单行列表(单行集合/数据表),而不是单个项,这也许很有用,具体取决于你打算如何使用数据。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
最大字符串长度
|
MaxStringLength | integer |
说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
找到的元素数
|
NumberOfElementsFound | integer |
找到满足搜索条件的元素数。 |
|
返回的元素数
|
NumberOfElementsReturned | integer |
从搜索返回的元素数。 如果“要搜索的最大元素数”或“每个节点要搜索的最大子元素数”设置为较低的数字,则这可能小于找到的元素数。 |
|
Java 元素属性 JSON
|
JABElementPropertiesJSON | string |
找到与搜索条件匹配的 Java 元素的元素属性(采用 JSON 格式)。 |
全局中间鼠标单击 Java 元素
将鼠标移动到 Java 元素的中心,然后单击中间鼠标按钮。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
单击偏移 X
|
ClickOffsetX | integer |
要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。 |
|
|
单击偏移 Y
|
ClickOffsetY | integer |
要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。 |
|
|
相对于
|
OffsetRelativeTo | string |
要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
全局双鼠标左键单击 Java 元素
将鼠标移动到 Java 元素的中心,然后双击鼠标左键。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
单击偏移 X
|
ClickOffsetX | integer |
要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。 |
|
|
单击偏移 Y
|
ClickOffsetY | integer |
要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。 |
|
|
相对于
|
OffsetRelativeTo | string |
要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。 |
|
|
延迟(以毫秒为单位)
|
DelayInMilliseconds | integer |
第一次单击和第二次单击之间的延迟(以毫秒为单位)。 默认值为 10 毫秒。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
全局鼠标单击 Java 表单元格
将鼠标移动到 Java 表格单元格的中心,然后单击指定的鼠标按钮。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
单元格行索引
|
RowIndex | True | integer |
表中单元格的行索引,从 1 开始。 |
|
单元格列索引
|
ColumnIndex | True | integer |
表中单元格的列索引,从 1 开始。 |
|
枚举视区
|
EnumerateViewport | boolean |
视区元素通常包含表,并表示表的可见区域。 如果设置为“True”(默认值),则 IA-Connect 代理将通过计算视区的大小来尝试检测表可见边界和每个角单元格的索引。 这使你可以确定表的哪些组件当前在屏幕上可见。 如果设置为“False”,则不会填充视区坐标。 |
|
|
处理视区父级
|
ProcessViewportParents | boolean |
如果设置为“True”(默认值),则还将处理视区父元素,以帮助优化视区可见大小。 如果它嵌入到另一个视区中,这非常有用。 如果设置为“False”,则不会处理视区父元素。 |
|
|
要处理的最大视区父级
|
MaxViewportParentsToProcess | integer |
枚举视区时要处理的父元素的最大数目。 默认情况下,此值设置为 50。 |
|
|
要考虑的视区父元素角色
|
ViewportParentElementRolesToConsider | string |
枚举以计算视区大小时要考虑的视区父元素的角色。 这用于排除大小小于视口的父元素,这些元素可能会倾斜大小计算,例如页面选项卡。 默认情况下,这些为:面板、视区、分层窗格、根窗格。 |
|
|
视区左边距
|
ViewportLeftMargin | integer |
枚举视区左内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区上边距
|
ViewportTopMargin | integer |
枚举视区顶部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区右边距
|
ViewportRightMargin | integer |
枚举视区的右内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区下边距
|
ViewportBottomMargin | integer |
枚举视区底部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
鼠标按钮
|
MouseButton | True | integer |
单击表格单元格时要使用的鼠标按钮。 Left = 0,Right = 1,Middle = 2,Double left = 3。 |
|
单击偏移 X
|
ClickOffsetX | integer |
要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。 |
|
|
单击偏移 Y
|
ClickOffsetY | integer |
要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。 |
|
|
相对于
|
OffsetRelativeTo | string |
要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。 |
|
|
延迟(以毫秒为单位)
|
DelayInMilliseconds | integer |
单击之间等待的秒数,默认情况下为 0.05(20 毫秒)。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
全局鼠标右键单击 Java 元素
将鼠标移动到 Java 元素的中心,然后单击鼠标右键。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
单击偏移 X
|
ClickOffsetX | integer |
要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。 |
|
|
单击偏移 Y
|
ClickOffsetY | integer |
要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。 |
|
|
相对于
|
OffsetRelativeTo | string |
要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
全局鼠标左键单击 Java 元素
将鼠标移动到 Java 元素的中心,然后单击鼠标左键。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
单击偏移 X
|
ClickOffsetX | integer |
要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。 |
|
|
单击偏移 Y
|
ClickOffsetY | integer |
要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。 |
|
|
相对于
|
OffsetRelativeTo | string |
要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。 |
|
|
单击元素的次数
|
NumberOfTimesToClickElement | integer |
单击元素的次数,默认情况下为 1。 |
|
|
在单击之间等待的秒数
|
SecondsToWaitBetweenClicks | double |
单击之间等待的秒数,默认情况下为 0。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
围绕 Java 元素绘制矩形
在 Java 元素的外围周围绘制一个矩形,以帮助确定找到的元素是必需的。 矩形在 5 秒后自动删除。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
笔颜色
|
PenColour | string |
要绘制的矩形的颜色(例如红色、绿色、蓝色、黄色、紫色或橙色)或字符串十六进制代码(例如 #FF0000)。 |
|
|
笔粗像素
|
PenThicknessPixels | integer |
突出显示矩形边框的粗细(以像素为单位)。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
在 Java 元素中输入密码
将密码输入 Java 元素(通常是密码输入字段),替换现有文本。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
输入密码
|
PasswordToInput | True | password |
要输入的密码值。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
在屏幕坐标处为 Java 元素创建句柄
通过提供屏幕坐标来创建 Java 元素的句柄。 如果 Java 元素存在于指定坐标处,该作将标识该元素并返回该元素的句柄。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
ParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
屏幕 X
|
ScreenX | True | integer |
屏幕 X 坐标(以像素为单位),以像素为单位查找元素。 |
|
屏幕 Y
|
ScreenY | True | integer |
要在其中找到元素的屏幕 Y 坐标(以像素为单位)。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
定位元素 JAB 句柄
|
LocatedElementJABHandle | integer |
如果元素存在于指定坐标处,则将保存一个数值元素句柄,该句柄可用于进一步作以充当“父”句柄,以便进一步搜索(即查找相对于句柄的元素)。 |
在屏幕坐标处获取 Java 表单元格
如果作为表的子元素的 Java 表单元格存在于指定的坐标处,此作将标识元素及其属性,并选择性地返回表单元格元素的句柄。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Table 元素 JAB 句柄
|
TableElementJABHandle | True | integer |
要搜索的父表元素的 Java 元素句柄。 这可能是之前使用“获取 Java 元素属性”找到的表。 |
|
屏幕 X
|
ScreenX | True | integer |
屏幕 X 坐标(以像素为单位),用于查找表单元格的位置。 |
|
屏幕 Y
|
ScreenY | True | integer |
要查找表单元格的屏幕 Y 坐标(以像素为单位)。 |
|
返回句柄
|
ReturnJABHandle | boolean |
是否应为单元格返回元素句柄? |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
父级的单元格索引
|
CellIndexInParent | integer |
表中单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。 |
|
单元格行索引
|
CellRowIndex | integer |
表中单元格的行索引,从 1 开始。 |
|
单元格列索引
|
CellColumnIndex | integer |
表中单元格的列索引,从 1 开始。 |
|
单元格 JAB 句柄
|
CellJABHandle | integer |
表单元格的元素句柄。 |
对 Java 元素执行作
执行 Java 元素的可访问作。 可以使用“获取 Java 元素的作”作来查询特定元素的这些可访问作。 对于文本元素,一些常见作是按钮的“click”或“select-all”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
Action
|
Action | True | string |
要执行的作,例如“click”。 作名称通常区分大小写。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
将全局输入文本写入 Java 元素
将鼠标移动到 Java 元素的中心,将鼠标焦点放在它、左键和按下键。 通常用于不接受本机 UIA 输入法的文本输入。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
Focus 元素首先
|
FocusElement | boolean |
是否应 IA-Connect 尝试在全局单击之前聚焦元素? |
|
|
全局鼠标左键单击元素
|
GlobalMouseClickOnElement | boolean |
在输入文本之前,是否应在元素坐标(以聚焦元素)处执行全局鼠标单击? |
|
|
使用双击删除鼠标替换现有值
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
是否应通过双击鼠标(突出显示它),然后删除来替换任何现有值? |
|
|
使用 CTRL-A delete 替换现有值
|
ReplaceExistingValueUsingCTRLADelete | boolean |
是否应按 Ctrl-A 替换任何现有值(要突出显示所有值),然后删除? 某些元素可能不支持使用 Ctrl-A 突出显示,在这种情况下,应尝试“使用双击删除替换现有值”的替代选项。 |
|
|
要输入的文本
|
TextToInput | string |
使用键盘将文本值设置为全局输入。 |
|
|
使用发送密钥事件
|
SendKeyEvents | boolean |
如果设置为 true,则将使用将模拟击键发送到作系统的较低级别的 API。 如果设置为 false,则会改用将击键发送到焦点元素的更高级别的 API。 |
|
|
密钥间隔(以毫秒为单位)
|
KeyIntervalInMilliseconds | integer |
每个按键之间的毫秒数。 |
|
|
双击间隔(以毫秒为单位)
|
DoubleClickIntervalInMilliseconds | integer |
如果参数“使用双击删除替换现有值”设置为 true,则每次单击之间的毫秒数。 |
|
|
不解释符号
|
DontInterpretSymbols | boolean |
“要输入的文本”中的符号是否不应解释为特殊键(例如,对于 Shift、^ for Ctrl)? 如果尝试输入实际符号,则应将其设置为 true。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
将文本输入 Java 元素
将文本输入 Java 元素(通常是文本输入字段),要么替换现有文本,要么将新值插入到特定位置。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要输入的文本
|
TextToInput | string |
要输入的文本值。 |
|
|
替换现有值
|
ReplaceExistingValue | boolean |
如果元素中存在现有文本,应将其替换? |
|
|
插入位置
|
InsertPosition | integer |
开始插入文本的位置(索引)。 如果存在现有文本,则插入位置可用于在现有文本中的特定位置插入。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
屏幕上可见的 Java 表单元格
返回 Java 表元素中的特定表单元格当前是否在屏幕上可见。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
处理视区父级
|
ProcessViewportParents | boolean |
如果设置为“True”(默认值),则还将处理视区父元素,以帮助优化视区可见大小。 如果它嵌入到另一个视区中,这非常有用。 如果设置为“False”,则不会处理视区父元素。 |
|
|
要处理的最大视区父级
|
MaxViewportParentsToProcess | integer |
枚举视区时要处理的父元素的最大数目。 默认情况下,此值设置为 50。 |
|
|
要考虑的视区父元素角色
|
ViewportParentElementRolesToConsider | string |
枚举以计算视区大小时要考虑的视区父元素的角色。 这用于排除大小小于视口的父元素,这些元素可能会倾斜大小计算,例如页面选项卡。 默认情况下,这些为:面板、视区、分层窗格、根窗格。 |
|
|
视区左边距
|
ViewportLeftMargin | integer |
枚举视区左内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区上边距
|
ViewportTopMargin | integer |
枚举视区顶部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区右边距
|
ViewportRightMargin | integer |
枚举视区的右内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区下边距
|
ViewportBottomMargin | integer |
枚举视区底部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
单元格行索引
|
CellRowIndex | True | integer |
表中单元格的行索引,从 1 开始。 |
|
单元格列索引
|
CellColumnIndex | True | integer |
表中单元格的列索引,从 1 开始。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
屏幕上的单元格
|
CellOnScreen | boolean |
如果指定的单元格当前在屏幕上显示,则返回 true;否则返回 false。 |
|
结果是肯定的
|
ResultIsCertain | boolean |
如果“屏幕上的单元格”结果是确定的,则返回 true。 如果无法计算 4 个父表边界中的任何一个,则此值将设置为“False”。 |
|
屏幕外方向
|
OffscreenDirection | string |
指定单元格的屏幕外方向的文本表示形式,例如上方、下方、左侧或右侧。 如果单元格位于“上”和“左”或“右”,则将返回为“上图”。 同样,如果单元格位于 AND Left 或 Right 下方,则此作将返回为 Below。 |
展开 Java 选择元素
展开或折叠 Java 元素(通常是菜单/下拉列表项)。 如果项已展开,则不会发生任何作。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
展开
|
Expand | boolean |
如果设置为“True”(默认值),则元素将展开。 如果设置为“False”,则元素将折叠。 |
|
|
验证元素状态
|
VerifyElementState | boolean |
如果设置为“True”,则之后 IA-Connect 代理将验证元素状态,以检查“Expanded”状态是否与预期状态匹配,如果不匹配,则会引发异常。 例如,如果展开元素,则“IsExpanded”属性应为 true。 如果设置为“False”,则不会验证元素状态。 |
|
|
等待状态更改的秒数
|
SecondsToWaitForStateChange | double |
展开或折叠后等待状态更改的秒数。 默认情况下,此值设置为 0.05(20 毫秒)。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
按 Java 元素
按 Java 元素(通常是按钮)。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
按元素的次数
|
NumberOfTimesToPressElement | integer |
按元素的次数,默认情况下为 1。 |
|
|
在按下之间等待的秒数
|
SecondsToWaitBetweenPresses | double |
在按下之间等待的秒数,默认情况下为 0.05(20 毫秒)。 |
|
|
自动检测作名称
|
AutoDetectActionName | boolean |
如果设置为 true(默认值),IA-Connect 代理将尝试自动检测非英语区域设置中的“click”作名称。 如果元素有两个以上的可能作,则将使用“替代作名称”。 如果设置为 false,则 IA-Connect 代理不会尝试检测非英语区域设置中的“click”作名称,除非提供了“替代作名称”值,否则该作可能会失败。 |
|
|
重写作名称
|
OverrideActionName | string |
非英语区域设置中的“Click”作的名称,例如“cliquer”或“hacer clic”。 这可以从作“获取 Java 元素的作”的输出中确定,并且通常区分大小写。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
按名称获取 Java 选择状态
通过提供子元素名称返回所选内容(通常是列表或下拉列表中的项)中的子元素的选择状态。 可以使用作“获取 Java 选择元素项”检索所有选择子元素项来检查其名称。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
物料名称
|
ItemName | True | string |
要选择或取消选择的列表项的名称。 |
|
项名称区分大小写
|
ItemNameCaseSensitive | boolean |
如果设置为“True”,则项名称搜索将区分大小写(例如,它必须与列表项完全匹配)。 如果设置为“False”(默认值),则项名称搜索将不区分大小写。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
已选择名称
|
NameIsSelected | boolean |
如果所选的命名选择列表项处于选中状态,则返回 true;否则返回 false。 |
按名称选择 Java 列表元素
选择具有指定名称的列表元素。 这通常用于在下拉菜单/菜单项中选择项。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
物料名称
|
ItemName | True | string |
要选择或取消选择的列表项的名称。 |
|
选择项
|
SelectItem | boolean |
如果设置为“True”(默认值),则将选择该项。 如果设置为“False”,则将取消选中该项。 这通常仅用于多选。 |
|
|
项名称区分大小写
|
ItemNameCaseSensitive | boolean |
如果设置为“True”,则项名称搜索将区分大小写(例如,它必须与列表项完全匹配)。 如果设置为“False”(默认值),则项名称搜索将不区分大小写。 |
|
|
首先清除所选内容
|
ClearSelectionFirst | boolean |
如果设置为“True”(默认值),则首先清除所选内容。 这主要用于多选,因为你需要选择其他项还是只选择单个项(首先清除)。 如果设置为“False”,则不会首先清除所选内容。 |
|
|
通过选择获取选项列表
|
GetListOfOptionsBySelecting | boolean |
如果设置为“True”,则 IA-Connect 代理将尝试通过依次选择每个选项(在 JAB 中)获取所选内容中的所有选项的列表。 如果设置为“False”(默认值),则“通过读取标签获取选项列表”参数应设置为“True”,否则不会读取选项列表。 |
|
|
通过读取标签获取选项列表
|
GetListOfOptionsByReadingLabels | boolean |
如果设置为“True”(默认值),则 IA-Connect 代理将尝试通过读取子标签(在 JAB 树中)获取所选内容中所有选项的列表。 对于下拉列表,几乎肯定会需要将“Expand first”参数设置为“True”,因为在列表下拉列表之前不会公开子元素。 此外,将“Collapse after”参数设置为“True”以在之后关闭列表。 “通过选择获取选项列表”参数也应设置为“False”,否则将忽略此选项(因为无法通过这两种方法获取列表)。 如果设置为“False”,则“通过选择”参数获取选项列表应设置为“True”,否则不会读取选项列表。 |
|
|
首先展开
|
ExpandFirst | boolean |
如果设置为“true”(默认值),则在搜索列表项元素之前,该作将尝试展开列表。 这对于动态列表非常有用,因为在展开列表之前,可能不会创建其他列表项元素。 如果设置为“false”,则列表将不会展开。 |
|
|
折叠后
|
CollapseAfter | boolean |
如果设置为 true(默认值),则在执行搜索后,列表将折叠。 如果设置为 false,则列表将不会折叠。 |
|
|
展开和折叠之间的秒数
|
SecondsBetweenExpandCollapse | double |
如果展开作和折叠作设置为“True”,则等待的秒数。 默认情况下,这是 0.05 (20 毫秒)。 |
|
|
强制,即使处于正确的状态
|
ForceEvenIfInCorrectState | boolean |
如果设置为“True”,则即使已选择该元素,也会选择该元素。 如果设置为“False”(默认值),则如果已选择列表元素,则 IA-Connect 代理将不执行任何作。 |
|
|
故障时恢复
|
RecoverOnFailure | boolean |
如果设置为“True”,则在新选择失败时,将恢复最初选择的列表项。 例如,如果选择了第 3 项,然后尝试选择第 90 项(不存在),则重新选择第 3 项。 如果设置为“False”,则不会恢复最初选择的列表项。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
按索引获取 Java 选择状态
通过提供子元素索引返回所选内容(通常是列表或下拉列表中的项)中的子元素的选择状态。 可以使用作“获取 Java 选择元素项”检索所有选择子元素项来检查其索引。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
项索引
|
ItemIndex | True | integer |
要查询的列表项状态的索引(从 1 开始)。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
已选择索引
|
IndexIsSelected | boolean |
如果指定的索引处的选择列表项处于选中状态,则返回 true;否则返回 false。 |
按索引选择 Java 列表元素
选择与指定索引匹配的列表元素。 这通常用于在下拉菜单/菜单项中选择项。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
项索引
|
ItemIndex | True | integer |
要选择或取消选择的列表项的索引(从 1 开始)。 |
|
选择项
|
SelectItem | boolean |
如果设置为“True”(默认值),则将选择该项。 如果设置为“False”,则将取消选中该项。 这通常仅用于多选。 |
|
|
首先清除所选内容
|
ClearSelectionFirst | boolean |
如果设置为“True”(默认值),则首先清除所选内容。 这主要用于多选,因为你需要选择其他项还是只选择单个项(首先清除)。 如果设置为“False”,则不会首先清除所选内容。 |
|
|
故障时恢复
|
RecoverOnFailure | boolean |
如果设置为“True”,则在新选择失败时,将恢复最初选择的列表项。 例如,如果选择了第 3 项,然后尝试选择第 90 项(不存在),则重新选择第 3 项。 如果设置为“False”,则不会恢复最初选择的列表项。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
断开与 Java 访问网桥的连接
关闭任何运行 IA-Connect Java 子系统(IA-JavaAccessBridge)。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
禁用 Java 访问网桥
|
DisableJavaAccessBridge | boolean |
是否应禁用 Java 访问桥? 默认情况下,此值设置为“True”。 |
|
|
辅助功能文件路径
|
AccessibilityFilepath | string |
.accessibility.properties 文件的路径,用于控制是否启用 Java 访问桥。 如果未提供路径,则默认为 %USERPROFILE%.accessibility.properties。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
是 Java 窗口
返回 UIA 窗口是否为 Java 元素。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父窗口句柄
|
ParentWindowHandle | True | integer |
要充当搜索起点的父 UIA 窗口句柄。 这可以通过使用 UIA作(如“等待桌面元素”或“等待元素”)进行检查来发现。 |
|
搜索元素名称
|
SearchElementName | string |
要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
Search 元素类名
|
SearchElementClassName | string |
要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索元素自动化 ID
|
SearchElementAutomationId | string |
要搜索的可选 UIA 元素自动化 ID(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索元素本地化控件类型
|
SearchLocalizedControlType | string |
要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索 UIA 子树
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
是 Java 窗口
|
IsJavaWindow | boolean |
如果找到的 UIA 元素是 Java 窗口,则返回 true;否则返回 false。 |
检查 Java 元素
将元素(通常是复选框或单选框)的状态设置为选中或未选中。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
Check 元素
|
CheckElement | boolean |
元素应选中(true)还是未选中(false)? |
|
|
自动检测作名称
|
AutoDetectActionName | boolean |
如果设置为 true(默认值),IA-Connect 代理将尝试自动检测非英语区域设置中的“click”作名称。 如果元素有两个以上的可能作,则将使用“替代作名称”。 如果设置为 false,则 IA-Connect 代理不会尝试检测非英语区域设置中的“click”作名称,除非提供了“替代作名称”值,否则该作可能会失败。 |
|
|
重写作名称
|
OverrideActionName | string |
非英语区域设置中的“Click”作的名称,例如“cliquer”或“hacer clic”。 这可以从作“获取 Java 元素的作”的输出中确定,并且通常区分大小写。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
等待 Java 元素
等待 Java 元素(通常是窗口内的单个元素(如按钮或文本输入区域)存在。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
等待的秒数
|
SecondsToWait | True | double |
等待元素存在的最大秒数。 |
|
如果未找到元素,引发异常
|
RaiseExceptionIfElementNotFound | boolean |
如果等待期后 Java 元素不存在,IA-Connect 是否应引发异常? |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果元素存在,则返回 true;否则返回 false。 |
|
元素 JAB 句柄
|
ElementJABHandle | integer |
如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。 |
|
元素名称
|
ElementName | string |
定位元素的 Java 名称。 |
|
元素说明
|
ElementDescription | string |
定位元素的 Java 说明(如果有)。 |
|
元素角色
|
ElementRole | string |
定位元素的 Java 角色(例如框架或面板)(如果有)。 |
等待 Java 元素不存在
等待 Java 元素(通常是窗口内的单个元素(如按钮或文本输入区域)不再存在。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
等待的秒数
|
SecondsToWait | True | double | |
|
如果元素仍然存在,则引发异常
|
RaiseExceptionIfElementStillExists | boolean |
如果 Java 元素在等待期后仍然存在,IA-Connect 是否应引发异常? |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素在等待之前存在
|
ElementExistsBeforeWait | boolean |
如果元素在等待之前存在,则返回 true;否则返回 false。 |
|
等待后存在元素
|
ElementExistsAfterWait | boolean |
如果元素在等待后存在,则返回 true;否则返回 false。 |
等待 Java 桌面元素
等待 Java 桌面元素(通常是窗口)存在。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
搜索 UIA 元素名称
|
SearchUIAElementName | string |
要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索 UIA 元素类名
|
SearchUIAElementClassName | string |
要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索 UIA 元素本地化控件类型
|
SearchUIAElementLocalizedControlType | string |
要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索进程 ID
|
SearchProcessID | integer |
正在运行的进程的进程 ID。 这可以作为“运行进程”作的输出进行检索。 |
|
|
搜索子元素
|
SearchChildElements | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
等待的秒数
|
SecondsToWait | True | double |
等待元素存在的最大秒数。 |
|
包括子进程
|
IncludeChildProcesses | boolean |
如果设置为 true 并且指定了“搜索进程 ID”,则搜索中将包含该进程 ID 的子进程。 这通常适用于 Java,因为启动器 EXE 通常会运行子级“Java(w).exe”进程。 如果设置为 false,则仅返回与确切的“搜索进程 ID”匹配的进程。 |
|
|
如果未找到元素,引发异常
|
RaiseExceptionIfElementNotFound | boolean |
如果等待期后 Java 元素不存在,IA-Connect 是否应引发异常? |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果元素存在,则返回 true;否则返回 false。 |
|
元素 JAB 句柄
|
ElementJABHandle | integer |
如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。 |
|
元素名称
|
ElementName | string |
定位元素的 Java 名称。 |
|
元素说明
|
ElementDescription | string |
定位元素的 Java 说明(如果有)。 |
|
元素角色
|
ElementRole | string |
定位元素的 Java 角色(例如框架或面板)(如果有)。 |
等待 Java 桌面元素不存在
等待 Java 桌面元素(通常是窗口)不再存在。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
搜索 UIA 元素名称
|
SearchUIAElementName | string |
要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索 UIA 元素类名
|
SearchUIAElementClassName | string |
要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索 UIA 元素本地化控件类型
|
SearchUIAElementLocalizedControlType | string |
要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索进程 ID
|
SearchProcessID | integer |
正在运行的进程的进程 ID。 这可以作为“运行进程”作的输出进行检索。 |
|
|
搜索子元素
|
SearchChildElements | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
等待的秒数
|
SecondsToWait | True | double |
等待元素不存在的最大秒数。 |
|
包括子进程
|
IncludeChildProcesses | boolean |
如果设置为 true 并且指定了“搜索进程 ID”,则搜索中将包含该进程 ID 的子进程。 这通常适用于 Java,因为启动器 EXE 通常会运行子级“Java(w).exe”进程。 如果设置为 false,则仅返回与确切的“搜索进程 ID”匹配的进程。 |
|
|
如果元素仍然存在,则引发异常
|
RaiseExceptionIfElementStillExists | boolean |
如果 Java 元素在等待期后仍然存在,IA-Connect 是否应引发异常? |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素在等待之前存在
|
ElementExistsBeforeWait | boolean |
如果元素在等待之前存在,则返回 true;否则返回 false。 |
|
等待后存在元素
|
ElementExistsAfterWait | boolean |
如果元素在等待后存在,则返回 true;否则返回 false。 |
获取 Java 元素值
返回元素的值。 值通常与文本输入区域相关联,但许多元素可以具有此属性。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素当前值
|
ElementCurrentValue | string |
元素的当前值。 |
|
元素最大值
|
ElementMaximumValue | string |
元素的最大值(如果指定)。 |
|
元素最小值
|
ElementMinimumValue | string |
元素的最小值(如果指定)。 |
获取 Java 元素属性
返回 Java 元素的所有 Java 属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
最大字符串长度
|
MaxStringLength | integer |
说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素 JAB 句柄
|
ElementJABHandle | integer |
如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。 |
|
元素 VMID
|
ElementVMID | integer |
运行 Java 程序的 Java 虚拟机的 ID。 |
|
元素名称
|
ElementName | string |
定位元素的 Java 名称。 |
|
元素说明
|
ElementDescription | string |
定位元素的 Java 说明(如果有)。 |
|
元素角色
|
ElementRole | string |
定位元素的 Java 角色(例如框架或面板)(如果有)。 |
|
元素状态
|
ElementStates | string |
代理会话的区域设置中 Java 元素支持的状态(例如可聚焦且可见)。 |
|
元素状态en_US
|
ElementStates_en_US | string |
en_US区域设置中 Java 元素支持的状态(例如可聚焦、可见)。 |
|
元素左边缘
|
ElementLeftEdge | integer |
Java 元素或窗口左边缘与显示左边缘之间的距离(以像素为单位)。 |
|
元素上边缘
|
ElementTopEdge | integer |
Java 元素或窗口上边缘与显示上边缘之间的距离(以像素为单位)。 |
|
元素宽度
|
ElementWidth | integer |
Java 元素的宽度(以像素为单位)。 |
|
元素高度
|
ElementHeight | integer |
Java 元素的高度(以像素为单位)。 |
|
元素右边缘
|
ElementRightEdge | integer |
Java 元素或窗口右边缘与显示左边缘之间的距离(以像素为单位)。 |
|
元素下边缘
|
ElementBottomEdge | integer |
Java 元素或窗口的下边缘与显示上边缘之间的距离(以像素为单位)。 |
|
是组件元素
|
IsComponentElement | boolean |
如果 Java 元素是容器,则返回 true;否则返回 false。 |
|
Is action 元素
|
IsActionElement | boolean |
如果 Java 元素是作元素,则返回 true;否则返回 false。 |
|
是选择元素
|
IsSelectionElement | boolean |
如果 Java 元素是选定内容,则返回 true;否则返回 false。 |
|
文本元素
|
IsTextElement | boolean |
如果 Java 元素是文本元素,则返回 true;否则返回 false。 |
|
已启用
|
IsEnabled | boolean |
如果启用 Java 元素,则返回 true;否则返回 false。 禁用的元素通常可见,但无法与之交互。 |
|
可见
|
IsVisible | boolean |
如果 Java 元素可见,则返回 true;否则返回 false。 |
|
正在显示
|
IsShowing | boolean |
如果 Java 元素显示,则返回 true;否则返回 false。 |
|
不透明
|
IsOpaque | boolean |
如果 Java 元素不透明,则返回 true;否则返回 false。 |
|
可聚焦
|
IsFocusable | boolean |
如果 Java 元素由键盘聚焦,则返回 true;否则返回 false。 这可能是有限的使用,因为大多数元素都是键盘可聚焦的。 |
|
可编辑
|
IsEditable | boolean |
如果 Java 元素是可编辑的,则返回 true;否则返回 false。 |
|
是单行
|
IsSingleLine | boolean |
如果 Java 元素是单行,则返回 true;否则返回 false。 |
|
可调整大小
|
IsResizable | boolean |
如果 Java 元素可调整大小,则返回 true;否则返回 false。 |
|
模式
|
IsModal | boolean |
如果 Java 元素为模式,则返回 true;否则返回 false。 模式元素将阻止主应用程序窗口,从而阻止你与其交互。 |
|
折叠
|
IsCollapsed | boolean |
如果 Java 元素已折叠,则返回 true;否则返回 false。 |
|
可选择
|
IsSelectable | boolean |
如果 Java 元素是可选择的,则返回 true;否则返回 false。 |
|
已选择
|
IsSelected | boolean |
如果选择 Java 元素,则返回 true;否则返回 false。 |
|
垂直
|
IsVertical | boolean |
如果 Java 元素为垂直,则返回 true;否则返回 false。 |
|
水平
|
IsHorizontal | boolean |
如果 Java 元素是水平元素,则返回 true;否则返回 false。 |
|
处于活动状态
|
IsActive | boolean |
如果 Java 元素处于活动状态,则返回 true;否则返回 false。 |
|
已选中
|
IsChecked | boolean |
如果选中 Java 元素,则返回 true;否则返回 false。 |
|
重点
|
IsFocussed | boolean |
如果 Java 元素具有键盘焦点,则返回 true。 如果不是,则为 false。 |
|
已展开
|
IsExpanded | boolean |
如果 Java 元素已展开,则返回 true;否则返回 false。 |
|
其他元素状态en_US
|
AdditionalStates_en_US | string |
元素支持的任何其他状态都将列在en_US区域设置中,例如多选的暂时性状态。 |
|
父级索引
|
IndexInParent | integer |
当前父元素中的元素索引。 |
|
元素子计数
|
ChildrenCount | integer |
元素具有的子元素数。 |
|
元素深度
|
ElementDepth | integer |
顶级父窗口中元素的深度。 |
获取 Java 元素文本值
返回 Java 元素的文本值。 文本值通常与文本元素相关联,但许多元素可以具有此属性。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素文本值
|
ElementTextValue | string |
元素的文本值。 |
获取 Java 元素的作
返回 Java 元素的可访问作。 然后,可以使用作名称作为作“对 Java 元素执行作”的作(例如“click”或“select-all”)的输入,对元素执行这些可访问作。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
辅助作
|
AccessibleActions | string |
搜索元素的所有可访问作的列表,例如“click”。 |
获取 Java 元素的可见边界矩形
检索 Java 元素的可见边界。 通常,Java Access Bridge 将返回元素的虚拟位置值,无论该元素在屏幕上是否可见,这些虚拟值都由“获取 Java 元素属性”作提供。 对于较大的元素(例如可滚动的表元素),因为这些元素可能并不总是在屏幕上可见,此作将返回元素当前可见区域的坐标。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
元素 JAB 句柄
|
ElementJABHandle | True | integer |
要为其返回可见边界的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。 |
|
要处理的最大父级数
|
MaxParentsToProcess | integer |
计算指定元素的可见大小时要处理的父元素的最大数目。 默认情况下,此值设置为 50。 |
|
|
要考虑的父元素角色
|
ParentElementRolesToConsider | string |
计算元素大小时要考虑的父元素的角色。 这用于排除小于可倾斜大小计算的元素(例如页面选项卡)的父元素。 默认情况下,这些为:面板、视区、分层窗格、根窗格。 |
|
|
绘制矩形
|
DrawRectangle | boolean |
是否 IA-Connect 在元素周围绘制一个矩形,以便在屏幕上可见? 默认情况下,此值设置为 false。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素可见矩形左侧
|
ElementVisibleRectangleLeft | integer |
元素的可见左边缘和显示左边缘之间的距离(以像素为单位)。 |
|
元素可见矩形顶部
|
ElementVisibleRectangleTop | integer |
元素的可见上边缘与显示上边缘之间的距离(以像素为单位)。 |
|
元素右侧可见矩形
|
ElementVisibleRectangleRight | integer |
元素的可见右边缘和显示器左边缘之间的距离(以像素为单位)。 |
|
元素可见矩形底部
|
ElementVisibleRectangleBottom | integer |
元素的可见下边缘与显示上边缘之间的距离(以像素为单位)。 |
|
元素可见矩形宽度
|
ElementVisibleRectangleWidth | integer |
元素的可见宽度(以像素为单位)。 |
|
元素可见矩形高度
|
ElementVisibleRectangleHeight | integer |
元素的可见高度(以像素为单位)。 |
获取 Java 子元素属性
返回由索引指定的特定 Java 子元素的所有属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Search 元素 JAB 句柄
|
SearchElementJABHandle | True | integer |
要为其返回子元素属性的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。 |
|
搜索子索引
|
SearchChildIndex | True | integer | |
|
最大字符串长度
|
MaxStringLength | integer |
说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素 JAB 句柄
|
ElementJABHandle | integer |
如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。 |
|
元素 VMID
|
ElementVMID | integer |
运行 Java 程序的 Java 虚拟机的 ID。 |
|
元素名称
|
ElementName | string |
定位元素的 Java 名称。 |
|
元素说明
|
ElementDescription | string |
定位元素的 Java 说明(如果有)。 |
|
元素角色
|
ElementRole | string |
定位元素的 Java 角色(例如框架或面板)(如果有)。 |
|
元素状态
|
ElementStates | string |
代理会话的区域设置中 Java 元素支持的状态(例如可聚焦且可见)。 |
|
元素状态en_US
|
ElementStates_en_US | string |
en_US区域设置中 Java 元素支持的状态(例如可聚焦、可见)。 |
|
元素左边缘
|
ElementLeftEdge | integer |
Java 元素或窗口左边缘与显示左边缘之间的距离(以像素为单位)。 |
|
元素上边缘
|
ElementTopEdge | integer |
Java 元素或窗口上边缘与显示上边缘之间的距离(以像素为单位)。 |
|
元素右边缘
|
ElementRightEdge | integer |
Java 元素或窗口右边缘与显示左边缘之间的距离(以像素为单位)。 |
|
元素下边缘
|
ElementBottomEdge | integer |
Java 元素或窗口的下边缘与显示上边缘之间的距离(以像素为单位)。 |
|
元素宽度
|
ElementWidth | integer |
Java 元素的宽度(以像素为单位)。 |
|
元素高度
|
ElementHeight | integer |
Java 元素的高度(以像素为单位)。 |
|
是组件元素
|
IsComponentElement | boolean |
如果 Java 元素是容器,则返回 true;否则返回 false。 |
|
Is action 元素
|
IsActionElement | boolean |
如果 Java 元素是作元素,则返回 true;否则返回 false。 |
|
是选择元素
|
IsSelectionElement | boolean |
如果 Java 元素是选定内容,则返回 true;否则返回 false。 |
|
文本元素
|
IsTextElement | boolean |
如果 Java 元素是文本元素,则返回 true;否则返回 false。 |
|
已启用
|
IsEnabled | boolean |
如果启用 Java 元素,则返回 true;否则返回 false。 禁用的元素通常可见,但无法与之交互。 |
|
可见
|
IsVisible | boolean |
如果 Java 元素可见,则返回 true;否则返回 false。 |
|
正在显示
|
IsShowing | boolean |
如果 Java 元素显示,则返回 true;否则返回 false。 |
|
不透明
|
IsOpaque | boolean |
如果 Java 元素不透明,则返回 true;否则返回 false。 |
|
可聚焦
|
IsFocusable | boolean |
如果 Java 元素由键盘聚焦,则返回 true;否则返回 false。 这可能是有限的使用,因为大多数元素都是键盘可聚焦的。 |
|
可编辑
|
IsEditable | boolean |
如果 Java 元素是可编辑的,则返回 true;否则返回 false。 |
|
是单行
|
IsSingleLine | boolean |
如果 Java 元素是单行,则返回 true;否则返回 false。 |
|
可调整大小
|
IsResizable | boolean |
如果 Java 元素可调整大小,则返回 true;否则返回 false。 |
|
模式
|
IsModal | boolean |
如果 Java 元素为模式,则返回 true;否则返回 false。 模式元素将阻止主应用程序窗口,从而阻止你与其交互。 |
|
折叠
|
IsCollapsed | boolean |
如果 Java 元素已折叠,则返回 true;否则返回 false。 |
|
可选择
|
IsSelectable | boolean |
如果 Java 元素是可选择的,则返回 true;否则返回 false。 |
|
已选择
|
IsSelected | boolean |
如果选择 Java 元素,则返回 true;否则返回 false。 |
|
垂直
|
IsVertical | boolean |
如果 Java 元素为垂直,则返回 true;否则返回 false。 |
|
水平
|
IsHorizontal | boolean |
如果 Java 元素是水平元素,则返回 true;否则返回 false。 |
|
处于活动状态
|
IsActive | boolean |
如果 Java 元素处于活动状态,则返回 true;否则返回 false。 |
|
已选中
|
IsChecked | boolean |
如果选中 Java 元素,则返回 true;否则返回 false。 |
|
重点
|
IsFocussed | boolean |
如果 Java 元素具有键盘焦点,则返回 true。 如果不是,则为 false。 |
|
已展开
|
IsExpanded | boolean |
如果 Java 元素已展开,则返回 true;否则返回 false。 |
|
其他元素状态en_US
|
AdditionalStates_en_US | string |
元素支持的任何其他状态都将列在en_US区域设置中,例如多选的暂时性状态。 |
|
父级索引
|
IndexInParent | integer |
当前父元素中的元素索引。 |
|
元素子计数
|
ChildrenCount | integer |
元素具有的子元素数。 |
|
元素深度
|
ElementDepth | integer |
顶级父窗口中元素的深度。 |
获取 Java 桌面元素
返回桌面上的 Java 应用程序窗口和对话框的列表。 必须首先连接到 Java 访问桥。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
搜索元素本地化控件类型
|
SearchElementLocalizedControlType | string |
要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索进程 ID
|
SearchProcessID | integer |
正在运行的进程的进程 ID。 这可以作为“运行进程”作的输出进行检索。 |
|
|
要返回的第一个项目
|
FirstItemToReturn | integer |
要返回的第一项的元素索引,从 1 开始。 如果要按反向顺序返回元素(从树底),也可以指定从 -1 开始的负索引。 例如,-10 的索引将从底部返回第十项。 |
|
|
要返回的最大项数
|
MaxItemsToReturn | integer |
要返回的最大元素数。 此参数可用于返回较小区块中的大型元素集,例如大型表。 可以一次返回 500 行,而不是尝试返回可能导致异常大型表超时的整个表。 |
|
|
搜索子元素
|
SearchChildElements | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大字符串长度
|
MaxStringLength | integer |
说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。 |
|
|
包括子进程
|
IncludeChildProcesses | boolean |
如果设置为 true 并且指定了“搜索进程 ID”,则搜索中将包含该进程 ID 的子进程。 这通常适用于 Java,因为启动器 EXE 通常会运行子级“Java(w).exe”进程。 如果设置为 false,则仅返回与确切的“搜索进程 ID”匹配的进程。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
找到的元素数
|
NumberOfElementsFound | integer |
找到满足搜索条件的元素数。 |
|
返回的元素数
|
NumberOfElementsReturned | integer |
从搜索返回的元素数。 如果“要返回的最大项数”设置为较低的数字,则这可能小于找到的元素数。 |
|
Java 桌面元素 JSON
|
JavaDesktopElementsJSON | string |
Java 桌面元素的元素属性以 JSON 格式找到与搜索条件匹配。 |
获取 Java 父元素属性
返回 Java 元素的父元素的属性。 此作将仅返回直接父元素的属性,并且不会搜索元素树的整个高度。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Search 元素 JAB 句柄
|
SearchElementJABHandle | True | integer |
要为其返回父元素属性的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。 |
|
最大字符串长度
|
MaxStringLength | integer |
说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素 JAB 句柄
|
ElementJABHandle | integer |
如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。 |
|
元素 VMID
|
ElementVMID | integer |
运行 Java 程序的 Java 虚拟机的 ID。 |
|
元素名称
|
ElementName | string |
定位元素的 Java 名称。 |
|
元素说明
|
ElementDescription | string |
定位元素的 Java 说明(如果有)。 |
|
元素角色
|
ElementRole | string |
定位元素的 Java 角色(例如框架或面板)(如果有)。 |
|
元素状态
|
ElementStates | string |
代理会话的区域设置中 Java 元素支持的状态(例如可聚焦且可见)。 |
|
元素状态en_US
|
ElementStates_en_US | string |
en_US区域设置中 Java 元素支持的状态(例如可聚焦、可见)。 |
|
元素左边缘
|
ElementLeftEdge | integer |
Java 元素或窗口左边缘与显示左边缘之间的距离(以像素为单位)。 |
|
元素上边缘
|
ElementTopEdge | integer |
Java 元素或窗口上边缘与显示上边缘之间的距离(以像素为单位)。 |
|
元素右边缘
|
ElementRightEdge | integer |
Java 元素或窗口右边缘与显示左边缘之间的距离(以像素为单位)。 |
|
元素下边缘
|
ElementBottomEdge | integer |
Java 元素或窗口的下边缘与显示上边缘之间的距离(以像素为单位)。 |
|
元素宽度
|
ElementWidth | integer |
Java 元素的宽度(以像素为单位)。 |
|
元素高度
|
ElementHeight | integer |
Java 元素的高度(以像素为单位)。 |
|
是组件元素
|
IsComponentElement | boolean |
如果 Java 元素是容器,则返回 true;否则返回 false。 |
|
Is action 元素
|
IsActionElement | boolean |
如果 Java 元素是作元素,则返回 true;否则返回 false。 |
|
是选择元素
|
IsSelectionElement | boolean |
如果 Java 元素是选定内容,则返回 true;否则返回 false。 |
|
文本元素
|
IsTextElement | boolean |
如果 Java 元素是文本元素,则返回 true;否则返回 false。 |
|
已启用
|
IsEnabled | boolean |
如果启用 Java 元素,则返回 true;否则返回 false。 禁用的元素通常可见,但无法与之交互。 |
|
可见
|
IsVisible | boolean |
如果 Java 元素可见,则返回 true;否则返回 false。 |
|
正在显示
|
IsShowing | boolean |
如果 Java 元素显示,则返回 true;否则返回 false。 |
|
不透明
|
IsOpaque | boolean |
如果 Java 元素不透明,则返回 true;否则返回 false。 |
|
可聚焦
|
IsFocusable | boolean |
如果 Java 元素由键盘聚焦,则返回 true;否则返回 false。 这可能是有限的使用,因为大多数元素都是键盘可聚焦的。 |
|
可编辑
|
IsEditable | boolean |
如果 Java 元素是可编辑的,则返回 true;否则返回 false。 |
|
是单行
|
IsSingleLine | boolean |
如果 Java 元素是单行,则返回 true;否则返回 false。 |
|
可调整大小
|
IsResizable | boolean |
如果 Java 元素可调整大小,则返回 true;否则返回 false。 |
|
模式
|
IsModal | boolean |
如果 Java 元素为模式,则返回 true;否则返回 false。 模式元素将阻止主应用程序窗口,从而阻止你与其交互。 |
|
折叠
|
IsCollapsed | boolean |
如果 Java 元素已折叠,则返回 true;否则返回 false。 |
|
可选择
|
IsSelectable | boolean |
如果 Java 元素是可选择的,则返回 true;否则返回 false。 |
|
已选择
|
IsSelected | boolean |
如果选择 Java 元素,则返回 true;否则返回 false。 |
|
垂直
|
IsVertical | boolean |
如果 Java 元素为垂直,则返回 true;否则返回 false。 |
|
水平
|
IsHorizontal | boolean |
如果 Java 元素是水平元素,则返回 true;否则返回 false。 |
|
处于活动状态
|
IsActive | boolean |
如果 Java 元素处于活动状态,则返回 true;否则返回 false。 |
|
已选中
|
IsChecked | boolean |
如果选中 Java 元素,则返回 true;否则返回 false。 |
|
重点
|
IsFocussed | boolean |
如果 Java 元素具有键盘焦点,则返回 true。 如果不是,则为 false。 |
|
已展开
|
IsExpanded | boolean |
如果 Java 元素已展开,则返回 true;否则返回 false。 |
|
其他元素状态en_US
|
AdditionalStates_en_US | string |
元素支持的任何其他状态都将列在en_US区域设置中,例如多选的暂时性状态。 |
|
父级索引
|
IndexInParent | integer |
当前父元素中的元素索引。 |
|
元素子计数
|
ChildrenCount | integer |
元素具有的子元素数。 |
|
元素深度
|
ElementDepth | integer |
顶级父窗口中元素的深度。 |
获取 Java 表内容
返回 Java 表元素的内容。 这是包含行、列、标题和单元格(即表)的元素。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要返回的第一行
|
FirstRowToReturn | integer |
要返回的第一行的索引。 默认情况下,此值设置为 1。 |
|
|
要返回的最大行数
|
MaxRowsToReturn | integer |
要返回的最大行数。 默认情况下,返回所有行。 |
|
|
要返回的第一列
|
FirstColumnToReturn | integer |
要返回的第一列的索引。 默认情况下,此值设置为 1。 |
|
|
要返回的最大列数
|
MaxColumnsToReturn | integer |
要返回的最大列数。 默认情况下,返回所有列。 |
|
|
使用表中的列标题
|
UseColumnHeadersFromTable | boolean |
如果设置为“True”,则 IA-Connect 代理将尝试返回输出集合列以匹配 Java 表中的列名。 如果设置为“False”(默认值),则集合中的列标题将称为“Column_N”(因为集合不能有空名称)。 |
|
|
返回输出集合中的行索引
|
ReturnRowIndexInOutputCollection | boolean |
如果设置为“True”(默认值),则 IA-Connect Agent 会将输出集合中的行索引作为附加列返回。 默认情况下,行索引列将称为“Row_index”,但可以通过在“列名称”中传递列名来存储行索引“参数来更改此列名。 如果计划筛选输出集合并跟踪筛选结果与哪个行相关,这非常有用。 如果设置为“False”,则不返回行索引列。 |
|
|
要存储行索引的列的名称
|
NameOfColumnToStoreRowIndex | string |
如果“输出集合中的返回行索引”设置为“True”,则可以通过在此处提供值来替代默认列名“_Row_Index”。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
表中的行数
|
NumberOfRowsInTable | integer |
表格的行数。 |
|
表中的列数
|
NumberOfColumnsInTable | integer |
表格的列数。 |
|
所选行数
|
NumberOfSelectedRows | integer |
当前选定的行数。 |
|
所选列数
|
NumberOfSelectedColumns | integer |
当前选择的列数。 |
|
返回的行数
|
NumberOfRowsReturned | integer |
返回的行数,如果“要返回的最大行数”设置为较低的数字,则返回的行数可能小于找到的行数。 |
|
返回的列数
|
NumberOfColumnsReturned | integer |
返回的列数,如果“要返回的最大列数”设置为较低的数字,则返回的列数可能小于找到的列数。 |
|
表内容 JSON
|
TableContentsJSON | string |
表元素的内容,采用 JSON 格式。 如果“使用表中的列标题”设置为 true,则此集合的列名将与表元素的列名匹配。 如果列名为空,则集合中将调用“Column_N”(因为集合不能有空名称)。 如果列名是重复的,它将将“_N”追加到名称(因为集合不能具有重复的列名)。 |
获取 Java 表单元格属性
返回 Java 表元素中指定单元格的属性和内容。 这是包含行、列、标题和单元格(即表)的元素。 可以选择性地指定是否通过枚举视区来确定单元格当前在屏幕上是否可见,以及该单元格是否为坐标。 视区元素通常包含表(例如它是表的父元素),并表示表的可见区域。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
单元格行索引
|
RowIndex | True | integer |
表中单元格的行索引,从 1 开始。 |
|
单元格列索引
|
ColumnIndex | True | integer |
表中单元格的列索引,从 1 开始。 |
|
返回句柄
|
ReturnJABHandle | boolean |
如果设置为 true,则将返回单元格的元素句柄。 |
|
|
枚举视区
|
EnumerateViewport | boolean |
视区元素通常包含表,并表示表的可见区域。 如果设置为“True”(默认值),则 IA-Connect 代理将通过计算视区的大小来尝试检测表可见边界和每个角单元格的索引。 这使你可以确定表的哪些组件当前在屏幕上可见。 如果设置为“False”,则不会填充视区坐标。 |
|
|
处理视区父级
|
ProcessViewportParents | boolean |
如果设置为“True”(默认值),则还将处理视区父元素,以帮助优化视区可见大小。 如果它嵌入到另一个视区中,这非常有用。 如果设置为“False”,则不会处理视区父元素。 |
|
|
要处理的最大视区父级
|
MaxViewportParentsToProcess | integer |
枚举视区时要处理的父元素的最大数目。 默认情况下,此值设置为 50。 |
|
|
要考虑的视区父元素角色
|
ViewportParentElementRolesToConsider | string |
枚举以计算视区大小时要考虑的视区父元素的角色。 这用于排除大小小于视口的父元素,这些元素可能会倾斜大小计算,例如页面选项卡。 默认情况下,这些为:面板、视区、分层窗格、根窗格。 |
|
|
视区左边距
|
ViewportLeftMargin | integer |
枚举视区左内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区上边距
|
ViewportTopMargin | integer |
枚举视区顶部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区右边距
|
ViewportRightMargin | integer |
枚举视区的右内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区下边距
|
ViewportBottomMargin | integer |
枚举视区底部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
单元格索引
|
CellIndex | integer |
表中的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。 |
|
单元格行区
|
RowExtent | integer |
单元格跨越的行数。 这通常为 1,除非单元格跨多行合并。 |
|
单元格列盘区
|
ColumnExtent | integer |
单元格跨越的列数。 这通常为 1,除非单元格跨多个列合并。 |
|
已选择单元格
|
IsSelected | boolean |
返回 true,如果单元格当前处于选中状态,则返回 false。 |
|
单元格内容
|
CellContents | string |
单元格的内容。 |
|
单元格左边缘
|
CellLeftEdge | integer |
单元格元素的左边缘与显示左边缘之间的距离(以像素为单位)。 |
|
单元格上边缘
|
CellTopEdge | integer |
单元格元素的上边缘与显示上边缘之间的距离(以像素为单位)。 |
|
单元格右边缘
|
CellRightEdge | integer |
单元格元素的右边缘和显示左边缘之间的距离(以像素为单位)。 |
|
单元格下边缘
|
CellBottomEdge | integer |
单元格元素的下边缘与显示上边缘之间的距离(以像素为单位)。 |
|
单元格宽度
|
CellWidth | integer |
单元格元素的宽度(以像素为单位)。 |
|
单元格高度
|
CellHeight | integer |
单元格元素的高度(以像素为单位)。 |
|
单元格在屏幕上可见
|
CellOnscreen | boolean |
如果单元格在屏幕上可见,则返回 true;否则返回 false。 |
|
可见结果是肯定的
|
CellVisibleResultIsCertain | boolean |
如果“单元格在屏幕上可见”结果是确定的,则返回 true。 如果无法计算 4 个父表边界中的任何一个,则此值将设置为“False”。 |
|
单元格 JAB 句柄
|
CellJABHandle | integer |
表单元格的元素句柄。 |
获取 Java 表属性
返回 Java 表元素的属性。 这是包含行、列、标题和单元格(即表)的元素。 可以选择通过枚举视区来确定表的哪些组件当前在屏幕上可见。 视区元素通常包含表(例如它是表的父元素),并表示表的可见区域。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
枚举视区
|
EnumerateViewport | boolean |
视区元素通常包含表,并表示表的可见区域。 如果设置为“True”(默认值),则 IA-Connect 代理将通过计算视区的大小来尝试检测表可见边界和每个角单元格的索引。 这使你可以确定表的哪些组件当前在屏幕上可见。 如果设置为“False”,则不会填充视区坐标。 |
|
|
处理视区父级
|
ProcessViewportParents | boolean |
如果设置为“True”(默认值),则还将处理视区父元素,以帮助优化视区可见大小。 如果它嵌入到另一个视区中,这非常有用。 如果设置为“False”,则不会处理视区父元素。 |
|
|
要处理的最大视区父级
|
MaxViewportParentsToProcess | integer |
枚举视区时要处理的父元素的最大数目。 默认情况下,此值设置为 50。 |
|
|
要考虑的视区父元素角色
|
ViewportParentElementRolesToConsider | string |
枚举以计算视区大小时要考虑的视区父元素的角色。 这用于排除大小小于视口的父元素,这些元素可能会倾斜大小计算,例如页面选项卡。 默认情况下,这些为:面板、视区、分层窗格、根窗格。 |
|
|
视区左边距
|
ViewportLeftMargin | integer |
枚举视区左内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区上边距
|
ViewportTopMargin | integer |
枚举视区顶部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区右边距
|
ViewportRightMargin | integer |
枚举视区的右内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
视区下边距
|
ViewportBottomMargin | integer |
枚举视区底部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
行数
|
NumberOfRows | integer |
表格的行数。 |
|
列数
|
NumberOfColumns | integer |
表格的列数。 |
|
所选行数
|
NumberOfSelectedRows | integer |
当前选定的行数。 |
|
所选列数
|
NumberOfSelectedColumns | integer |
当前选择的列数。 |
|
行标题中的行数
|
NumberOfRowsInRowHeader | integer |
行标题中的行数。 这通常为 0,因为表很少具有行标题。 |
|
列标题中的列数
|
NumberOfColumnsInColumnHeader | integer |
列标题中的列数。 |
|
视区位于
|
ViewportLocated | boolean |
如果视区已找到,则返回 true;否则返回 false。 如果这是“True”,则返回视区坐标。 |
|
视区左边缘
|
ViewportLeftEdge | integer |
视区元素的左边缘和显示器左边缘之间的距离(以像素为单位)。 |
|
视区上边缘
|
ViewportTopEdge | integer |
视区元素上边缘与显示器上边缘之间的距离(以像素为单位)。 |
|
视区宽度
|
ViewportWidth | integer |
视区元素的宽度(以像素为单位)。 |
|
视区高度
|
ViewportHeight | integer |
视区元素的高度(以像素为单位)。 |
|
视区右边缘
|
ViewportRightEdge | integer |
视区元素的右边缘和显示器左边缘之间的距离(以像素为单位)。 |
|
视区下边缘
|
ViewportBottomEdge | integer |
视区元素的下边缘与显示器上边缘之间的距离(以像素为单位)。 |
|
父级左上方可见单元格索引
|
TopLeftVisibleCellIndexInParent | integer |
表中左上角可见单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。 |
|
左上方可见行索引
|
TopLeftVisibleCellRowIndex | integer |
表中左上方可见单元格的行索引。 |
|
左上可见列索引
|
TopLeftVisibleCellColumnIndex | integer |
表中左上方可见单元格的列索引。 |
|
父级右上方可见单元格索引
|
TopRightVisibleCellIndexInParent | integer |
表中右上可见单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。 |
|
右上可见行索引
|
TopRightVisibleCellRowIndex | integer |
表中右上可见单元格的行索引。 |
|
右上可见列索引
|
TopRightVisibleCellColumnIndex | integer |
表中右上可见单元格的列索引。 |
|
父级左下可见单元格索引
|
BottomLeftVisibleCellIndexInParent | integer |
表中左下可见单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。 |
|
左下可见行索引
|
BottomLeftVisibleCellRowIndex | integer |
表中左下可见单元格的行索引。 |
|
左下可见列索引
|
BottomLeftVisibleCellColumnIndex | integer |
表中左下可见单元格的列索引。 |
|
父级右下可见单元格索引
|
BottomRightVisibleCellIndexInParent | integer |
表中右下角可见单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。 |
|
右下角可见行索引
|
BottomRightVisibleCellRowIndex | integer |
表中右下角可见单元格的行索引。 |
|
右下可见列索引
|
BottomRightVisibleCellColumnIndex | integer |
表中右下可见单元格的列索引。 |
|
最左侧可见的列索引
|
LeftmostVisibleColumnIndex | integer |
最左侧可见列的列索引。 |
|
最右侧可见的列索引
|
RightmostVisibleColumnIndex | integer |
最右侧可见列的列索引。 |
|
最顶部可见的行索引
|
TopmostVisibleRowIndex | integer |
最上面的可见行的行索引。 |
|
最底部可见的行索引
|
BottommostVisibleRowIndex | integer |
最底部可见行的行索引。 |
获取 Java 选择元素项
返回在指定 Java 选择元素下找到的所有子选择元素项。 可以选择通过循环选择、选择列表中的每个单独选项或读取所选内容的子元素的标签来检索选择元素选项。 如果选择通过读取所选内容的子元素的标签来检索选择元素选项,则可能需要先通过将“Expand first”参数作为“True”来展开所选内容,然后还可以选择关闭所选内容,同时提供“Collapse after”参数作为“True”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父元素 JAB 句柄
|
SearchParentElementJABHandle | True | integer |
Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。 |
|
搜索 Java 元素名称
|
SearchElementJABName | string |
要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素说明
|
SearchElementJABDescription | string |
要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。 |
|
|
搜索 Java 元素角色
|
SearchElementJABRole | string |
要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
搜索子元素
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。 |
|
|
仅搜索可见元素
|
OnlySearchVisibleElements | boolean |
是否应只搜索可见元素? 默认情况下,此值设置为 true。 |
|
|
仅显示元素的搜索
|
OnlySearchShowingElements | boolean |
是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。 |
|
|
不遍历的元素角色
|
ElementRolesNotToTraverse | string |
一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
要搜索的最大元素数
|
MaximumElementsToSearch | integer |
查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
每个节点要搜索的最大子元素数
|
MaximumChildElementsToSearchPerNode | integer |
查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。 |
|
|
通过选择获取选项列表
|
GetListOfOptionsBySelecting | boolean |
如果设置为“True”,则 IA-Connect 代理将尝试通过依次选择每个选项(在 JAB 中)获取所选内容中的所有选项的列表。 如果设置为“False”(默认值),则“通过读取标签获取选项列表”参数应设置为“True”,否则不会读取选项列表。 |
|
|
通过读取标签获取选项列表
|
GetListOfOptionsByReadingLabels | boolean |
如果设置为“True”,则 IA-Connect 代理将尝试通过读取子标签(在 JAB 树中)获取所选内容中所有选项的列表。 对于下拉列表,几乎肯定会需要将“Expand first”参数设置为“True”,因为在列表下拉列表之前不会公开子元素。 此外,将“Collapse after”参数设置为“True”以在之后关闭列表。 “通过选择获取选项列表”参数也应设置为“False”,否则将忽略此选项(因为无法通过这两种方法获取列表)。 如果设置为“False”(默认值),则“通过选择”参数获取选项列表应设置为“True”,否则不会读取选项列表。 |
|
|
首先展开
|
ExpandFirst | boolean |
如果设置为“true”,则在搜索列表项元素之前,该作将尝试展开列表。 这对于动态列表非常有用,因为在展开列表之前,可能不会创建其他列表项元素。 如果设置为 false(默认值),则列表将不会展开。 |
|
|
折叠后
|
CollapseAfter | boolean |
如果设置为 true,则在执行搜索后,列表将折叠。 如果设置为 false(默认值),则列表将不会折叠。 |
|
|
展开和折叠之间的秒数
|
SecondsBetweenExpandCollapse | double |
如果展开作和折叠作设置为“True”,则等待的秒数。 默认情况下,这是 0.05 (20 毫秒)。 |
|
|
要返回的最大列表项数
|
MaxListItemsToReturn | integer |
要返回的列表项的最大数目,默认情况下为 100。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
所选项数
|
NumberOfSelectedItems | integer |
在当前选定的父选择元素下找到的子列表项数。 |
|
选择 1 名称
|
AccessibleSelection1Name | string |
第一个选定的子列表项的名称。 |
|
列表中的选择 1 索引
|
AccessibleSelection1IndexInParent | integer |
第一个选定子列表项列表中的索引。 |
|
所选项目 JSON
|
JABSelectionSelectedItemsJSON | string |
父选择元素的选定子列表项,采用 JSON 格式。 |
|
选择列表项 JSON
|
JABSelectionListItemsJSON | string |
父选择元素的所有子列表项,采用 JSON 格式。 |
获取 UIA 元素的 Java 属性
返回 UIA 元素的所有 Java 属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
父窗口句柄
|
ParentWindowHandle | True | integer |
要充当搜索起点的父 UIA 窗口句柄。 这可以通过使用 UIA作(如“等待桌面元素”或“等待元素”)进行检查来发现。 |
|
搜索元素名称
|
SearchElementName | string |
要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
Search 元素类名
|
SearchElementClassName | string |
要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索元素自动化 ID
|
SearchElementAutomationId | string |
要搜索的可选 UIA 元素自动化 ID(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索元素本地化控件类型
|
SearchLocalizedControlType | string |
要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。 |
|
|
搜索 UIA 子树
|
SearchSubTree | boolean |
如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。 |
|
|
搜索筛选器
|
SearchFilter | string |
可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。 |
|
|
按列名称排序
|
SortByColumn | string |
如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。 |
|
|
匹配索引升序
|
MatchIndexAscending | boolean |
如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。 |
|
|
最大字符串长度
|
MaxStringLength | integer |
说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
元素 JAB 句柄
|
ElementJABHandle | integer |
如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。 |
|
元素 VMID
|
ElementVMID | integer |
运行 Java 程序的 Java 虚拟机的 ID。 |
|
元素名称
|
ElementName | string |
定位元素的 Java 名称。 |
|
元素说明
|
ElementDescription | string |
定位元素的 Java 说明(如果有)。 |
|
元素角色
|
ElementRole | string |
定位元素的 Java 角色(例如框架或面板)(如果有)。 |
|
元素状态
|
ElementStates | string |
代理会话的区域设置中 Java 元素支持的状态(例如可聚焦且可见)。 |
|
元素状态en_US
|
ElementStates_en_US | string |
en_US区域设置中 Java 元素支持的状态(例如可聚焦、可见)。 |
|
元素左边缘
|
ElementLeftEdge | integer |
Java 元素或窗口左边缘与显示左边缘之间的距离(以像素为单位)。 |
|
元素上边缘
|
ElementTopEdge | integer |
Java 元素或窗口上边缘与显示上边缘之间的距离(以像素为单位)。 |
|
元素宽度
|
ElementWidth | integer |
Java 元素的宽度(以像素为单位)。 |
|
元素高度
|
ElementHeight | integer |
Java 元素的高度(以像素为单位)。 |
|
元素右边缘
|
ElementRightEdge | integer |
Java 元素或窗口右边缘与显示左边缘之间的距离(以像素为单位)。 |
|
元素下边缘
|
ElementBottomEdge | integer |
Java 元素或窗口的下边缘与显示上边缘之间的距离(以像素为单位)。 |
|
是组件元素
|
IsComponentElement | boolean |
如果 Java 元素是容器,则返回 true;否则返回 false。 |
|
Is action 元素
|
IsActionElement | boolean |
如果 Java 元素是作元素,则返回 true;否则返回 false。 |
|
是选择元素
|
IsSelectionElement | boolean |
如果 Java 元素是选定内容,则返回 true;否则返回 false。 |
|
文本元素
|
IsTextElement | boolean |
如果 Java 元素是文本元素,则返回 true;否则返回 false。 |
|
已启用
|
IsEnabled | boolean |
如果启用 Java 元素,则返回 true;否则返回 false。 禁用的元素通常可见,但无法与之交互。 |
|
可见
|
IsVisible | boolean |
如果 Java 元素可见,则返回 true;否则返回 false。 |
|
正在显示
|
IsShowing | boolean |
如果 Java 元素显示,则返回 true;否则返回 false。 |
|
不透明
|
IsOpaque | boolean |
如果 Java 元素不透明,则返回 true;否则返回 false。 |
|
可聚焦
|
IsFocusable | boolean |
如果 Java 元素由键盘聚焦,则返回 true;否则返回 false。 这可能是有限的使用,因为大多数元素都是键盘可聚焦的。 |
|
可编辑
|
IsEditable | boolean |
如果 Java 元素是可编辑的,则返回 true;否则返回 false。 |
|
是单行
|
IsSingleLine | boolean |
如果 Java 元素是单行,则返回 true;否则返回 false。 |
|
可调整大小
|
IsResizable | boolean |
如果 Java 元素可调整大小,则返回 true;否则返回 false。 |
|
模式
|
IsModal | boolean |
如果 Java 元素为模式,则返回 true;否则返回 false。 模式元素将阻止主应用程序窗口,从而阻止你与其交互。 |
|
折叠
|
IsCollapsed | boolean |
如果 Java 元素已折叠,则返回 true;否则返回 false。 |
|
可选择
|
IsSelectable | boolean |
如果 Java 元素是可选择的,则返回 true;否则返回 false。 |
|
已选择
|
IsSelected | boolean |
如果选择 Java 元素,则返回 true;否则返回 false。 |
|
垂直
|
IsVertical | boolean |
如果 Java 元素为垂直,则返回 true;否则返回 false。 |
|
水平
|
IsHorizontal | boolean |
如果 Java 元素是水平元素,则返回 true;否则返回 false。 |
|
处于活动状态
|
IsActive | boolean |
如果 Java 元素处于活动状态,则返回 true;否则返回 false。 |
|
已选中
|
IsChecked | boolean |
如果选中 Java 元素,则返回 true;否则返回 false。 |
|
重点
|
IsFocussed | boolean |
如果 Java 元素具有键盘焦点,则返回 true。 如果不是,则为 false。 |
|
已展开
|
IsExpanded | boolean |
如果 Java 元素已展开,则返回 true;否则返回 false。 |
|
其他元素状态en_US
|
AdditionalStates_en_US | string |
元素支持的任何其他状态都将列在en_US区域设置中,例如多选的暂时性状态。 |
|
父级索引
|
IndexInParent | integer |
当前父元素中的元素索引。 |
|
元素子计数
|
ChildrenCount | integer |
元素具有的子元素数。 |
|
元素深度
|
ElementDepth | integer |
顶级父窗口中元素的深度。 |
获取 Windows 访问网桥信息
返回有关特定 Java VM ID(包括 Java 和 Windows DLL 版本)的 Windows 访问桥(WAB)的信息。 Java VM ID 可以作为“获取 Java 元素属性”作的输出获取。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
虚拟机ID
|
VMID | True | integer |
Java 虚拟机 ID。 这在所有 Java 虚拟机中都是唯一的。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Java 类版本
|
JavaClassVersion | string |
Java 类版本,例如“1.8.0_261”。 |
|
Java DLL 版本
|
JavaDLLVersion | string |
Java DLL 版本,例如“1.8.0_261”。 |
|
Windows DLL 版本
|
WinDLLVersion | string |
Windows DLL 版本,例如“1.8.0_261”。 |
|
VM 版本
|
VMVersion | string |
Java VM 版本,例如“1.8.0_261”。 |
获取 Windows 访问网桥连接状态
返回 IA-Connect 代理与 Windows 访问网桥(WAB)之间的连接的当前状态。 如果 IA-Connect 代理连接到 WAB,则相关详细信息将作为输出返回。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
已连接的 WAB
|
Connected | boolean |
如果 IA-Connect 代理连接到 Windows 访问桥,则返回 true;否则返回 false。 |
|
WAB 连接类型
|
ConnectionType | string |
与 Windows 访问桥的连接类型,例如 COM 或 Native 和 32 位或 64 位。 |
|
WAB 64 位
|
IsWAB64bit | boolean |
如果 Windows 访问桥为 64 位,则返回 true;否则返回 false。 |
|
连接错误
|
ConnectionError | string |
连接错误(如果报告了连接错误)。 |
|
加载 IA-JavaAccessBridge COM DLL
|
LoadedIAJABDLL | string |
加载 IA-JavaAccessBridge COM DLL 的完整路径。 |
|
加载的 Windows 访问桥 DLL
|
LoadedWABDLL | string |
加载的 Windows 访问桥 DLL 的完整路径。 |
|
Windows Access Bridge DLL 版本
|
WABVersion | string |
加载的 Windows 访问桥 DLL 的版本。 |
获取多个 Java 父元素属性
返回 Java 元素的所有父元素的属性。 如果“要处理的最大父级”参数设置得足够高,此作将搜索返回所有父属性的元素树的整个高度。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Search 元素 JAB 句柄
|
SearchElementJABHandle | True | integer |
要为其返回所有父元素属性的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。 |
|
最大字符串长度
|
MaxStringLength | integer |
说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。 |
|
|
要处理的最大父级数
|
MaxParentsToProcess | integer |
要处理的父元素的最大数目。 默认情况下,此值设置为 50。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Java 父元素 JSON
|
JavaParentElementsJSON | string |
JSON 格式的所有定位父元素的列表(及其属性)。 返回的属性与“获取 Java 元素属性”作返回的属性相同。 |
|
返回的父元素数
|
NumberOfParentElementsReturned | integer |
从搜索返回的父元素数。 |
获取所有 Java 子元素属性
返回所有 Java 子元素的所有属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Search 元素 JAB 句柄
|
SearchElementJABHandle | True | integer |
要为其返回子元素属性的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。 |
|
要返回的第一个项目
|
FirstItemToReturn | integer |
要返回的第一项的元素索引,从 1 开始。 如果要按反向顺序返回元素(从树底),也可以指定从 -1 开始的负索引。 例如,-10 的索引将从底部返回第十项。 |
|
|
要返回的最大项数
|
MaxItemsToReturn | integer |
要返回的最大元素数。 此参数可用于返回较小区块中的大型元素集,例如大型表。 可以一次返回 500 行,而不是尝试返回可能导致异常大型表超时的整个表。 |
|
|
最大字符串长度
|
MaxStringLength | integer |
说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。 |
|
|
搜索后代
|
SearchDescendants | boolean |
如果设置为 true,则会搜索父句柄下的所有子元素。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,将只搜索父句柄的直接子元素。 |
|
|
搜索 Java 元素角色
|
SearchRole | string |
要搜索的子元素的可选 Java 元素角色。 可以通过检查发现这一点。 |
|
|
最大相对深度
|
MaxRelativeDepth | integer |
要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
返回的子元素数
|
NumberOfChildElementsReturned | integer |
从搜索返回的子元素数。 |
|
当前深度可用的更多元素
|
MoreElementsAvailableAtCurrentDepth | boolean |
如果当前深度上有更多的子元素未返回为“要返回的最大项”设置为较低的数字,则返回 true。 |
|
在较低深度上可用的更多元素
|
MoreElementsAvailableAtLowerDepths | boolean |
如果 Java 树的深度较低处有更多子元素可用,则返回 true;如果“要返回的最大项数”设置为较低的数字。 |
|
比最大深度更深的元素
|
MoreElementsDeeperThanMaxDepth | boolean |
如果 Java 树的最大深度下有更多的子元素可用,则返回 true,如果“最大相对深度”设置为较低的数字。 |
|
Java 子元素 JSON
|
JavaChildElementsJSON | string |
JSON 格式的所有定位子元素的列表(及其属性)。 返回的属性与“获取 Java 子元素属性”作返回的属性相同。 |
连接到 Java 访问网桥
启动 IA-Connect Java 子系统(IA-JavaAccessBridge),并将其连接到指定的 Java 访问桥 DLL(或留空搜索一个)。 必须先执行此步骤,然后才能自动执行 Java 应用程序。 此作还启用必须在运行任何 Java 应用程序之前启用的 Java 访问桥。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Windows Access Bridge DLL 搜索文件夹
|
WindowsAccessBridgeDLLSearchFolder | string |
在运行代理的会话中指定包含 Windows Access Bridge DLL(Java 运行时的组件)的文件夹,或输入 Windows Access Bridge DLL 的完整文件名以强制使用该特定 DLL。 如果未提供路径,则将使用标准 Windows 搜索路径。 |
|
|
IA-JavaAccessBridge DLL 路径
|
IAJavaAccessBridgePath | string |
如果需要将 IA-JavaAccessBridge.dll COM DLL(IA-Connect 代理的内置组件)的位置托管在 EXE 外部(可能是由于安全允许列表)。 这可以是完整路径,也可以是相对于 IA-Connect 代理位置的路径。 例如,如果代理和 IA-JavaAccessBridge.dll COM DLL 都位于同一文件夹中,则只需传递 DLL 的文件名就足够了。 |
|
|
是 64 位 Windows 访问桥 DLL
|
Is64BitJABDLL | boolean |
是否使用 Windows 访问桥 DLL 64 位? |
|
|
将 COM 用于 64 位 IA-JavaAccessBridge DLL
|
UseCOMFor64BitJABDLL | boolean |
如果尝试加载的 Windows 访问网桥 DLL 为 64 位,则应通过进程外 COM DLLSurrogate 运行,而不是从 IA-Connect 直接(内存中)调用。 默认情况下,此值设置为“True”。 如果阻止了 IA-JavaAccessBridge DLL,可以尝试取消选中此项。 |
|
|
启用 Java 访问网桥
|
EnableJavaAccessBridge | boolean |
是否应启用 Java 访问桥? 默认情况下,此值设置为“True”。 |
|
|
辅助功能文件路径
|
AccessibilityFilepath | string |
.accessibility.properties 文件的路径,用于控制是否启用 Java 访问桥。 如果未提供路径,则默认为 %USERPROFILE%.accessibility.properties。 |
|
|
命令超时(以秒为单位)
|
CommandTimeoutInSeconds | integer |
等待 IA-Connect 连接到 Java 访问桥的最大秒数。 默认情况下,这是 20 秒。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
加载的 Windows 访问桥 DLL
|
LoadedWindowsAccessBridgeDLL | string |
加载的 Windows Access Bridge DLL 的完整文件名。 |
重置所有 Java 元素句柄
重置当前由 IA-Connect 存储的所有 Java 元素句柄,如果已识别大量元素并存储了大量元素句柄,这非常有用。 在元素句柄数非常高(100,000+)的情况下,此作还可用于释放 RAM 使用情况。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |