获取桌面关联元素
指令说明
获取指定的桌面元素的父/子/兄弟/子孙元素，父元素始终只有一个，子元素和兄弟元素可能有多个，当查找到多个匹配的子孙元素时会报错，需要修改元素，以确保始终只能匹配到唯一元素。 子孙元素+index也可以实现获取指定元素的第n个直接子元素
指令输入参数
| 输入参数 | 输入参数类型 | 说明 |
|---|---|---|
| 桌面元素 | WinElement 或 ElementDescriptor | 可以选择捕获的桌面元素也可以选择获取桌面元素、获取桌面相似元素、获取桌面关联元素等指令获取到桌面元素 |
| 关联方式 | 枚举项 | 父元素、子元素、兄弟元素、子孙元素 |
| 子孙元素 | ElementDescriptor | 捕获的桌面元素，仅关联方式是子孙元素时需要该参数，会从上面的 桌面元素 参数开始查找子孙元素 |
| 等待元素出现时长 | float | 若元素未出现则一直等待，直到元素出现为止，若超过最长等待时间后元素仍未出现则触发错误或者返回空列表，单位：秒 |
指令输出参数
| 输出参数 | 输出参数类型 | 说明 |
|---|---|---|
| 桌面元素 | WinElement 或 List[WinElement] | 关联方式是父元素、子孙元素 时类型是WinElement，否则是 List[WinElement] |
类型定义参考
提示
- 捕获元素参考 捕获及编辑桌面元素属性
适用场景
- 当无法唯一定位元素时可以通过关联元素尝试获取期望的元素
- 商品列表中每件商品都有名称和价格，当获取到商品名称后可以通过关联元素获取这件商品对应的价格
示例
获取微信聊天记录中的群名称
微信聊天记录是List（列表），包含多个直接子元素Item项，每个Item是一个群或者联系人，每一项中都有群、联系人名称
流程
- 获取List元素
- 获取List的所有直接子元素Item
- 获取每个Item的子孙元素
-
List元素
-
子孙元素
由于需要查找Item的子孙元素，所以不能勾选ListItemControl及之前的元素
