获取桌面元素
指令说明
获取指定的桌面元素，进而获取其坐标、宽高、显示的文字等信息。
例如您可以直接使用下面的Python表达式获取相关数据：
| Python表达式 | 说明 |
|---|---|
winElement.name | 元素显示的文字 |
winElement.text | 输入框的文字 |
winElement.left | 当前桌面元素左侧相对于屏幕左侧的物理像素距离，会把元素所属窗口前置 |
winElement.top | 当前桌面元素顶部相对于屏幕顶部的物理像素距离，会把元素所属窗口前置 |
winElement.right | 当前桌面元素右侧相对于屏幕左侧的物理像素距离，会把元素所属窗口前置 |
winElement.bottom | 当前桌面元素底部相对于屏幕底部的物理像素距离，会把元素所属窗口前置 |
winElement.width | 当前桌面元素的物理像素宽度，会把元素所属窗口前置 |
winElement.height | 当前桌面元素的物理像素高度，会把元素所属窗口前置 |
其他winElement属性参考WinElement类定义
指令输入参数
| 输入参数 | 输入参数类型 | 说明 |
|---|---|---|
| 桌面元素 | ElementDescriptor | 捕获的桌面元素 |
| 等待元素出现时长 | float | 若元素未出现则一直等待，直到元素出现为止，若超过最长等待时间后元素仍未出现则触发错误，单位：秒 |
指令输出参数
| 输出参数 | 输出参数类型 | 说明 |
|---|---|---|
| 桌面元素 | WinElement | winElement 有left、top、right、bottom等属性，这些属性值是相对于屏幕左上角的像素值，当获取这些属性时会自动把窗口前置 |
类型定义参考
提示
- 捕获元素参考 捕获及编辑桌面元素属性
- 曲辕RPA拥有强大的类型管理机制，可以通过对象直接获取相关信息，无需借助其他指令，这种机制可以减少对象数量，简化流程复杂度，流程更加直观清晰
