UI 自动化操作

重要提示

要防止未经授权的访问，Power Automate 需要以与其自动化的应用程序相同或更高的特权运行。 要使用 UI 自动化操作（使用桌面操作除外）与以提升特权运行的应用程序交互，请以管理员身份运行 Power Automate。 要查找有关以管理员身份运行 Power Automate 的详细信息，请转到以提升的权限运行 Power Automate。

Power Automate 提供各个 UI 自动化操作，使用户能够与 Windows 和桌面应用程序交互。 有些 UI 自动化操作需要您在其属性中设置 UI 元素以指示要处理的元素。

要添加新的 UI 元素，通过部署的 UI 自动化操作或流设计器的 UI 元素窗格选择添加 UI 元素。

所有 UI 元素都由定位组件层次结构的选择器组成。 选择器使用 > 表示法指示每个元素都包含在其左侧的元素中。

创建应用程序窗口的 UI 元素时，其选择器始终具有名为 :desktop 的根元素。

如果您创建一个 UI 元素来定位应用程序窗口内的某个组件，将会自动创建两个 UI 元素。 父 UI 元素定位应用程序窗口，而子元素显示窗口内特定组件的层次结构。

虽然在添加 UI 元素时会自动创建选择器，但某些特定场景需要手动创建的选择器。 当需要自定义选择器时，您可以编辑现有选择器或从头开始构建一个选择器。

要开发更多动态流，请将等于运算符替换为其他运算符或正则表达式。 此外，如果选择器的属性值取决于先前操作的结果，请使用变量而不是硬编码值。

对于 UI 自动化的许多操作来说，有两种执行操作的模式：物理和模拟。 在物理模式下，该工具控制机器的鼠标和键盘以物理方式执行操作。 在模拟模式下，操作以编程方式执行，无需控制鼠标和键盘，也无需将 UI 元素的屏幕置于前台。 需要注意的是，模拟选项可能并不适用于每个 UI 元素。 要通过模拟执行操作，请在某些操作中启用模拟操作参数，或者在其他操作中禁用前置参数。

备注

要查找有关开发 UI 自动化流和创建自定义选择器的详细信息，请转到自动化桌面流和构建自定义选择器。

获取窗口详细信息

获取窗口的属性，例如其标题或源文本。

输入参数

参数	可选	接受	默认值	说明
窗口	否	UI 元素		要从中获取详细信息的窗口
窗口属性	不适用	获取窗口标题、获取窗口文本、获取窗口位置和大小、获取进程名称	获取窗口标题	选择要提取的窗口属性
放到最前面	不可用	布尔值	TRUE	指定包含 UI 元素的窗口在执行期间是否将被置于最前面。 如果禁用此选项，则该操作将在后台执行。 请注意，并非所有 UI 元素都与禁用该选项兼容。 此外，如果执行操作需要滚动，则禁用此选项可能不会提取所有元素。

生成的变量

参数	类型​​	Description
WindowProperty	常规值	检索的窗口信息

异常

例外	描述
无法检索窗口的属性	指示检索窗口属性时遇到问题

获取窗口中的 UI 元素的详细信息

获取窗口中 UI 元素的属性值。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		要从中获取详细信息的 UI 元素
属性名称	是	文本值	自己的文本	要检索其值的属性
放到最前面	不可用	布尔值	TRUE	指定包含 UI 元素的窗口在执行期间是否将被置于最前面。 如果禁用此选项，则该操作将在后台执行。 请注意，并非所有 UI 元素都与禁用该选项兼容。 此外，如果执行操作需要滚动，则禁用此选项可能不会提取所有元素。

生成的变量

参数	类型​​	Description
AttributeValue	文本值	UI 元素文本的值

异常

例外	描述
无法检索 UI 元素的属性	指示检索 UI 元素的属性时遇到问题

获取窗口中的选定复选框

检索复选框组中选定复选框的名称或特定复选框的状态。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		复选框或复选框组
操作	不适用	获取组中选定复选框的名称、获取复选框的状态	获取组中选定复选框的名称	指定是检索多个选定复选框的状态还是只检索一个
放到最前面	不可用	布尔值	TRUE	指定包含 UI 元素的窗口在执行期间是否将被置于最前面。 如果禁用此选项，则该操作将在后台执行。 请注意，并非所有 UI 元素都与禁用该选项兼容。 此外，如果执行操作需要滚动，则禁用此选项可能不会提取所有元素。

生成的变量

参数	类型​​	Description
IsChecked	布尔值	选定复选框的状态
SelectedCheckboxes	文本值列表	指定复选框组中选定复选框的名称

异常

例外	描述
无法检索复选框状态	指示检索指定复选框状态时遇到问题

获取窗口中的所选单选按钮

检索单选按钮组中所选单选按钮的名称或特定单选按钮的状态。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		单选按钮或单选按钮组
操作	不适用	获取组中所选单选按钮的名称、获取单选按钮的状态	获取组中所选单选按钮的名称	指定是检索单选按钮组中所选单选按钮的名称，还是仅检索单个单选按钮的状态
放到最前面	不可用	布尔值	TRUE	指定包含 UI 元素的窗口在执行期间是否将被置于最前面。 如果禁用此选项，则该操作将在后台执行。 请注意，并非所有 UI 元素都与禁用该选项兼容。 此外，如果执行操作需要滚动，则禁用此选项可能不会提取所有元素。

生成的变量

参数	类型​​	Description
IsSelected	布尔值	所选单选按钮的状态
SelectedRadiobutton	文本值	指定单选按钮组中的所选单选按钮

异常

例外	描述
无法检索单选按钮状态	指示检索指定单选按钮状态时遇到问题

从窗口中提取数据

从窗口的特定部分提取单个值、列表、或表形式的数据。

输入参数

参数	可选	接受	默认值	说明
窗口	否	UI 元素		要从中提取数据的窗口
将所提取数据存储到	不适用	Excel 电子表格、变量	Excel 电子表格	指定所提取数据的存储位置
放到最前面	不可用	布尔值	TRUE	指定包含 UI 元素的窗口在执行期间是否将被置于最前面。 如果禁用此选项，则该操作将在后台执行。 请注意，并非所有 UI 元素都与禁用该选项兼容。 此外，如果执行操作需要滚动，则禁用此选项可能不会提取所有元素。

生成的变量

参数	类型​​	Description
ExcelInstance	Excel 实例	具有所提取数据的 Excel 实例。 使用此实例通过专门的 Excel 操作来操作电子表格（或保存并关闭它）。
DataFromWindow	常规值	所提取的数据表形式的数据

异常

例外	描述
提取失败	指示从指定窗口中提取数据时遇到问题

获取 UI 元素的屏幕截图

获取窗口中的 UI 元素的屏幕截图。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		窗口中要以屏幕截图形式捕获的 UI 元素
保存模式	不适用	剪贴板、文件	剪贴板	指定是将图像保存到文件中还是将其存储到剪贴板中
Image file path	否	文件		设置要保存的文件的完整路径
File format	不适用	BMP、EMF、EXIF、GIF、JPG、PNG、TIFF、WMF	BMP	图像文件的文件格式

生成的变量

参数	类型​​	说明
ImageFile	文件	所生成的屏幕截图图像文件的文件路径

异常

例外	描述
无法检索 UI 元素	指示检索 UI 元素时遇到问题
无法保存图像	指示保存获取的屏幕截图时遇到问题
无法获取 UI 元素的屏幕截图	指示获取 UI 元素的屏幕截图时遇到问题

聚焦窗口中的文本字段

在窗口的文本框上设置焦点，并将其滚动到视图中。

输入参数

参数	可选	接受	默认值	说明
文本字段	否	UI 元素		要聚焦的文本框

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法在窗口文本框中设置输入焦点	指示在对指定的网页文本字段设置焦点时遇到问题

填充窗口中的文本字段

使用指定文本填充窗口中的文本框。

输入参数

参数	可选	接受	默认值	Description
Text box	否	UI 元素		要填充的文本框
要填充的文本	否	直接加密的输入或文本值		要在文本字段中填充的文本
模拟操作	不可用	布尔值	错误	在将文本填充到 UI 文本字段元素时，以编程方式模拟击键。 此选项不需要 UI元素的屏幕被聚焦，不会自动把它带到前台。 注意此选项只能应用于左键单击操作，可能不适用于每个 UI 元素。
如果字段不为空	是	替换文本、追加文本	替换文本	指定是替换现有内容还是追加。
Click before populating	是	左键单击、双击、否	左键单击	指定是否在填充文本字段前执行鼠标左键单击。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法写入文本框	指示填充指定文本字段时遇到问题

按下窗口中的按钮

按下窗口按钮。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		要按下的按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法按下按钮	指示按下指定按钮时遇到问题

选择窗口中的单选按钮

选择窗口中的单选按钮。

输入参数

参数	可选	接受	默认值	说明
Radio button	否	UI 元素		要选择的单选按钮

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法选择单选按钮 UI 元素	指示选择指定的单选按钮 UI 元素时遇到问题

设置窗口中复选框的状态

在窗口窗体中选中或取消选中复选框。

输入参数

参数	可选	接受	默认值	说明
复选框	否	UI 元素		要设置状态的复选框
将复选框状态设置为	不适用	已选中、已取消选中	已选中	指定复选框是变为选中还是未选中

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法设置复选框状态	指示设置指定复选框状态时遇到问题

设置窗口中的下拉列表值

设置或清除窗口窗体中下拉列表的选定选项。

输入参数

参数	可选	接受	默认值	说明
下拉列表	否	UI 元素		要设置其值的下拉列表
Operation	不可用	清除选定选项、选择选项（按名称）、选择选项（按索引）	清除选定选项	指定是要按名称或序号位置 (1 2 3 ...) 选择值，还是清除下拉列表中的选定值
选项名称	否	文本值列表		在下拉列表中输入要选择的选项或选项列表。 只有在使用多选列表时多个选项才有意义。 如果列表是单选，将仅使用指定的列表的第一个选项。
使用正则表达式	不适用	布尔值	False	指定选项是否指定了要解释为正则表达式的值
选项索引	否	数值列表		在下拉列表中输入要选择的索引或索引列表。 只有在使用多选列表时多个选项才有意义。 如果列表是单选，将仅使用指定的列表的第一个选项。

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法在下拉列表中选择指定的选项	指示在下拉列表中选择指定选项时出现问题

获取窗口

为自动化桌面应用程序获取正在运行的窗口。

输入参数

参数	可选	接受	默认值	说明
Get window	不适用	特定窗口、前景窗口	特定窗口	指定是使用选择器还是前景窗口进行查找
UI 元素	否	UI 元素		要获取的窗口的选择器
将窗口置于前端	不适用	布尔值	假	指定在获取窗口时是否自动将其引入前景
Fail if window isn't found	不适用	布尔值	真	指定是无限期地等待窗口显示，还是在设置的时间段内未显示窗口时失败
Timeout	否	数值		等待的超时时间(以秒为单位)

生成的变量

参数	类型​​	说明
WindowTitle	文本值	前景窗口的标题
AutomationWindow	窗口实例	与后期 UI 自动化操作配合使用的特定窗口实例

异常

例外	描述
无法获取窗口	指示获取窗口时遇到问题

聚焦窗口

激活并将特定窗口引入前景。

输入参数

参数	可选	接受	默认值	说明
Find window mode	不适用	按窗口 UI 元素、按窗口实例/句柄、按标题和/或类	按窗口 UI 元素	指定是使用 UI 元素还是窗口标题/类的组合来查找窗口
窗口	否	UI 元素		窗口 UI 元素
窗口标题	是	文本值		窗口标题。 可使用通配符，如“?”或“*”。
Window instance	否	数值		要聚焦的窗口的实例或句柄
Window class	是	文本值		如果两个窗口标题相同，窗口类可以帮助区分它们。 在此情况下，请输入要使用的窗口类。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到窗口	指示找不到指定的窗口
无法聚焦窗口	指示聚焦指定窗口时遇到问题
无法在非交互模式下执行与窗口相关的操作	指示在非交互模式下执行窗口相关操作时遇到问题

设置窗口状态

还原、最大化或最小化特定窗口。

输入参数

参数	可选	接受	默认值	说明
Find window mode	不适用	按窗口 UI 元素、按窗口实例/句柄、按标题和/或类	按窗口 UI 元素	指定是使用 UI 元素还是窗口标题/类的组合来查找窗口
窗口	否	UI 元素		窗口 UI 元素
窗口标题	是	文本值		窗口标题。 可使用通配符，如“?”或“*”。
Window instance	否	数值		用于设置状态的窗口的实例或句柄
Window class	是	文本值		如果两个窗口标题相同，窗口类可以帮助区分它们。 在此情况下，请输入要使用的窗口类。
Window state	不适用	已还原、最大化、最小化	已还原	选择显示窗口时的状态

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到窗口	指示找不到指定的窗口
无法设置窗口状态	指示设置指定窗口的窗口状态时遇到问题
无法在非交互模式下执行与窗口相关的操作	指示在非交互模式下执行窗口相关操作时遇到问题

设置窗口可见性

显示隐藏窗口或隐藏可见窗口。

输入参数

参数	可选	接受	默认值	说明
Find window mode	不适用	按窗口 UI 元素、按窗口实例/句柄、按标题和/或类	按窗口 UI 元素	指定是使用 UI 元素还是窗口标题/类的组合来查找窗口
窗口	否	UI 元素		窗口 UI 元素
窗口标题	是	文本值		窗口标题。 可使用通配符，如“?”或“*”。
Window instance	否	数值		用于设置可见性的窗口的实例或句柄
Window class	是	文本值		如果两个窗口标题相同，窗口类可以帮助区分它们。 在此情况下，请输入要使用的窗口类。
Visibility	不适用	可见、已隐藏	已隐藏	选择设置窗口可见性时的状态

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到窗口	指示找不到指定的窗口
无法设置窗口可见性	指示设置指定窗口的可见性时遇到问题
无法在非交互模式下执行与窗口相关的操作	指示在非交互模式下执行窗口相关操作时遇到问题

移动窗口

设置特定窗口的位置。

输入参数

参数	可选	接受	默认值	说明
Find window mode	不适用	按窗口 UI 元素、按窗口实例/句柄、按标题和/或类	按窗口 UI 元素	指定是使用 UI 元素还是窗口标题/类的组合来查找窗口
窗口	否	UI 元素		窗口 UI 元素
窗口标题	是	文本值		窗口标题。 可使用通配符，如“?”或“*”。
Window instance	否	数值		要移动的窗口的实例或句柄
Window class	是	文本值		如果两个窗口标题相同，窗口类可以帮助区分它们。 在此情况下，请输入要使用的窗口类。
Position X	否	数值		窗口的 X 位置
Position Y	否	数值		窗口的 Y 位置

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到窗口	指示找不到指定的窗口
无法移动窗口	指示移动指定窗口时遇到问题
无法在非交互模式下执行与窗口相关的操作	指示在非交互模式下执行窗口相关操作时遇到问题

调整窗口大小

设置特定窗口的大小。

输入参数

参数	可选	接受	默认值	说明
Find window mode	不适用	按窗口 UI 元素、按窗口实例/句柄、按标题和/或类	按窗口 UI 元素	指定是使用 UI 元素还是窗口标题/类的组合来查找窗口
窗口	否	UI 元素		窗口 UI 元素
窗口标题	是	文本值		窗口标题。 可使用通配符，如“?”或“*”。
Window instance	否	数值		用于调整大小的窗口的实例或句柄
Window class	是	文本值		如果两个窗口标题相同，窗口类可以帮助区分它们。 在此情况下，请输入要使用的窗口类
Width	否	数值		新宽度(以像素为单位)
Height	否	数值		新高度(以像素为单位)

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到窗口	指示找不到指定的窗口
无法调整窗口大小	指示调整指定窗口大小时遇到问题
无法在非交互模式下执行与窗口相关的操作	指示在非交互模式下执行窗口相关操作时遇到问题

关闭窗口

关闭特定窗口。

输入参数

参数	可选	接受	默认值	说明
Find window mode	不适用	按窗口 UI 元素、按窗口实例/句柄、按标题和/或类	按窗口 UI 元素	指定是使用 UI 元素还是窗口标题/类的组合来查找窗口
窗口	否	UI 元素		窗口 UI 元素
窗口标题	是	文本值		窗口标题。 可使用通配符，如“?”或“*”。
Window instance	否	数值		要关闭的窗口的实例或句柄
Window class	是	文本值		如果两个窗口标题相同，窗口类可以帮助区分它们。 在此情况下，请输入要使用的窗口类。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到窗口	指示找不到指定的窗口
无法关闭窗口	指示关闭指定窗口时遇到问题
无法在非交互模式下执行与窗口相关的操作	指示在非交互模式下执行窗口相关操作时遇到问题

如果窗口包含

此操作根据窗口中是否存在特定的文本片段或 UI 元素来标记条件操作块的开头。

输入参数

参数	可选	接受	默认值	说明
Check if window	不适用	包含 UI 元素、不包含 UI 元素、包含文本、不包含文本	包含 UI 元素	检查窗口中是否存在特定的文本或 UI 元素
Check UI element state	不适用	布尔值	假	检查是否已启用或禁用特定 UI 元素
文本	否	文本值		要检查的文本
UI 元素	否	UI 元素		要检查的 UI 元素
窗口	否	UI 元素		要检查其中是否存在文本的窗口
状态	不适用	已启用、已禁用	已启用	要检查的 UI 元素状态

生成的变量

此操作不会生成任何变量。

异常

此操作不包含任何例外。

等待窗口内容

挂起自动化的执行，直到特定文本或 UI 元素显示在窗口中或从窗口中消失。

输入参数

参数	可选	接受	默认值	说明
Wait until window	不适用	包含 UI 元素、不包含 UI 元素、包含文本、不包含文本	包含 UI 元素	是否等待特定的文本或 UI 元素显示在窗口中
Check UI element state	不适用	布尔值	假	检查是否已启用或禁用特定 UI 元素
文本	否	文本值		要检查的文本
UI 元素	否	UI 元素		要检查的 UI 元素
窗口	否	UI 元素		要检查其中是否存在文本的窗口
状态	不适用	已启用、已禁用	已启用	要检查的 UI 元素状态

生成的变量

此操作不会生成任何变量。

异常

例外	说明
等待窗口内容失败	指示等待操作失败

如果图像

此操作根据在屏幕上是否找到了所选图像来标记条件操作块的开头。

输入参数

参数	可选	接受	默认值	说明
If image	不适用	存在、不存在	存在	是否检查所选图像是否存在
图像	否	图像列表		操作将检查其是否存在的图像
搜索图像的位置	不适用	整个屏幕、仅限前景窗口	整个屏幕	是仅在最前端的窗口中查找指定图像，还是在整个可见屏幕中查找。 如果图像未在屏幕上清晰显示，则这两种选项都找不到它
Search mode	不适用	搜索整个屏幕或前景窗口、在屏幕或前景窗口的指定子区域中搜索	搜索整个屏幕或前景窗口	是扫描整个屏幕(或窗口)以查找所提供的文本，还是仅扫描缩小的屏幕子区域
Find all images in the list	不适用	布尔值	假	检查列表上的所有图像是否存在
X1	是	数值		用于扫描所提供文本的子区域的起始点 X 坐标
X2	是	数值		用于扫描所提供文本的子区域的结束点 X 坐标
Y1	是	数值		用于扫描所提供文本的子区域的起始点 Y 坐标
Y2	是	数值		用于扫描所提供文本的子区域的结束点 Y 坐标
Tolerance	是	数值	10	指定搜索的图像可与最初选择的图像存在的区别程度
图像匹配算法	不适用	基本、高级	基本	搜索图像时要使用的图像算法

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法在非交互模式下检查图像	指示无法在非交互模式中识别图像
子区域坐标无效	指示给定子区域的坐标无效

使用桌面

执行与桌面和任务栏相关的操作。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		要对其执行单击的 UI 元素
点击类型	不可用	左键单击、右键单击、双击	左键单击	要执行的单击类型
Launch new application when left-clicking on the taskbar	不适用	布尔值	真	当此参数设置为“true”时，可确保在左键单击“快速启动”栏（Windows 7 或更高版本中又称任务栏）中的相应图标时，将创建新的应用程序窗口。 取消选中此选项可将已在运行的应用程序实例引入前景。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
任务栏操作失败	指示任务栏操作失败

选择窗口中的选项卡

从选项卡组中选择选项卡。

输入参数

参数	可选	接受	默认值	说明
制表符	否	UI 元素		要选择的选项卡

生成的变量

此操作不会生成任何变量。

异常

例外	说明
选择选项卡失败	指示选择指定选项卡时遇到问题

等待图像

此操作将一直等待，直到屏幕或前景窗口上显示特定图像。

输入参数

参数	可选	接受	默认值	说明
Wait for image to	不适用	显示、消失	显示	检查是否等待图像显示或消失
要等待的图像	否	图像列表		操作将检查其是否存在的图像
搜索图像的位置	不适用	整个屏幕、仅限前景窗口	整个屏幕	是仅在最前端的窗口中查找指定图像，还是在整个可见屏幕中查找。 如果图像未在屏幕上清晰显示，则这两种选项都找不到它
Search mode	不适用	搜索整个屏幕或前景窗口、在屏幕或前景窗口的指定子区域中搜索	搜索整个屏幕或前景窗口	是扫描整个屏幕(或窗口)以查找所提供的文本，还是仅扫描缩小的屏幕子区域
Wait for all images	不适用	布尔值	假	是要等待列表中的所有图像显示(消失)，还是只等待其中一个
X1	是	数值		用于扫描所提供文本的子区域的起始点 X 坐标
X2	是	数值		用于扫描所提供文本的子区域的结束点 X 坐标
Y1	是	数值		用于扫描所提供文本的子区域的起始点 Y 坐标
Y2	是	数值		用于扫描所提供文本的子区域的结束点 Y 坐标
Tolerance	是	数值	10	指定搜索的图像可与最初选择的图像存在的区别程度
图像匹配算法	不适用	基本、高级	基本	搜索图像时要使用的图像算法
失败，出现超时错误	不适用	布尔值	False	指定是希望操作无限期等待还是在设定的时间段后失败

生成的变量

参数	类型​​	说明
X	数值	文本显示在屏幕上的相应点的 X 坐标。 如果在前景窗口中搜索文本，则此值是相对于窗口的左上角的值。
Y	数值	文本显示在屏幕上的相应点的 Y 坐标。 如果在前景窗口中搜索文本，则此值是相对于窗口的左上角的值。

异常

例外	描述
等待图像失败	指示等待操作失败
无法在非交互模式下检查图像	指示无法在非交互模式中识别图像
子区域坐标无效	指示给定子区域的坐标无效

将鼠标悬停在窗口中的 UI 元素上

将鼠标悬停在窗口上的任何 UI 元素上。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		选择要悬停在其上的窗口 UI 元素

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法将鼠标悬停在元素上方	指示将鼠标指针悬停在元素上失败

单击窗口中的 UI 元素

单击窗口中的任何 UI 元素。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		要单击的 UI 元素
点击类型	不可用	左键单击、右键单击、双击、中键单击、按下左键、上弹左键、按下右键、上弹右键	左键单击	要执行的单击类型
模拟操作	不可用	布尔值	错误	指定在单击之前是否模拟鼠标光标在元素上的移动。 此选项不需要 UI元素的屏幕被聚焦，不会自动把它带到前台。 注意此选项只能应用于左键单击操作，可能不适用于每个 UI 元素。
Mouse position relative to UI element	不可用	左上角、顶部中间、右上角、中间偏左、正中间、中间偏右、左下角、底部中间、右下角	正中间	指定单击前要将鼠标移动到 UI 元素的哪一部分
Offset X	是	文本值	0	鼠标从相应位置向右偏移多个像素
Offset Y	是	文本值	0	鼠标从相应位置向下偏移多个像素

生成的变量

此操作不会生成任何变量。

异常

例外	说明
单击失败	指示单击失败

选择窗口中的菜单选项

选择窗口菜单中的选项。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		要选择的菜单选项

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法选择选项	指示选择指定菜单选项时遇到问题

拖放窗口中的 UI 元素

拖放窗口的 UI 元素。

输入参数

参数	可选	接受	默认值	说明
要拖动的 UI 元素	否	UI 元素		要拖动的 UI 元素
要拖放的 UI 元素	否	UI 元素		要拖放的 UI 元素
点击类型	不可用	左键单击、右键单击	左键单击	指定在将 UI 元素拖到其目标上时用于单击并按住的鼠标按钮
Mouse down offset X	是	文本值	0	将鼠标向下单击(用于抓取要拖动的 UI 元素)向右偏移此数量的像素
Mouse down offset Y	是	文本值	0	将鼠标向下单击(用于抓取要拖动的 UI 元素)向下偏移此数量的像素
Mouse down position relative to drag-target UI element	不适用	左上角、顶部中间、右上角、中间偏左、正中间、中间偏右、左下角、底部中间、右下角	正中间	指定单击前要将鼠标放到 UI 元素的哪一部分
Mouse up offset X	是	文本值	0	将鼠标向上单击(用于抓取要拖动的 UI 元素)向右偏移此数量的像素
Mouse up offset Y	是	文本值	0	将鼠标向上单击(用于抓取要拖动的 UI 元素)向下偏移此数量的像素
Mouse up position relative to drop-target UI element	不适用	左上角、顶部中间、右上角、中间偏左、正中间、中间偏右、左下角、底部中间、右下角	正中间	指定单击后要将鼠标拖到 UI 元素的哪一部分

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到要拖动的 UI 元素	指示找不到要拖动的 UI 元素
找不到拖放目标 UI 元素	指示找不到拖放目标 UI 元素
拖放失败	指示在拖放指定 UI 元素期间遇到问题

在窗口中展开/折叠树节点

展开或折叠位于窗口中的树视图的节点。

输入参数

参数	可选	接受	默认值	说明
UI 元素	否	UI 元素		要展开/折叠的树节点
文件夹路径	是	文本值		由文件夹名称组成的以正斜线分隔的路径，指向要展开或折叠的树节点
Use regular expressions	不适用	布尔值	假	指定是否将路径中的每个文件夹名称都解释为正则表达式
Operation	不适用	展开、折叠	扩展	指定是否展开或折叠树节点

备注

Power Automate 的正则表达式引擎是 .NET。 要查找有关正则表达式的详细信息，请转到正则表达式语言 - 快速参考。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法将树节点设置为指定状态	指示将树节点设置为指定状态时遇到问题

如果窗口

此操作根据窗口是否已打开或窗口是否为聚焦(前景)窗口来标记条件操作块的开头。

输入参数

参数	可选	接受	默认值	说明
Get window	不适用	按窗口 UI 元素、按窗口实例/句柄、按标题和/或类	按窗口 UI 元素	指定是使用 UI 元素还是窗口标题/类的组合来查找窗口
Window title	是	文本值		窗口标题。 可使用通配符，如“?”或“*”。
窗口	否	UI 元素		窗口 UI 元素
窗口实例	否	数值		要检查的窗口的实例或句柄
Window class	是	文本值		如果两个窗口标题相同，窗口类可以帮助区分它们。 在此情况下，请输入要使用的窗口类。
Check if window	不适用	已打开、未打开、已聚焦、未聚焦	已打开	要检查的窗口的状态

生成的变量

此操作不会生成任何变量。

异常

此操作不包含任何例外。

等待窗口

在特定窗口打开、关闭、获得或失去焦点之前挂起执行或流程。

输入参数

参数	可选	接受	默认值	说明
Find window	不适用	按窗口 UI 元素、按窗口实例/句柄、按标题和/或类	按窗口 UI 元素	指定是使用 UI 元素还是窗口标题/类的组合来查找窗口
Window title	是	文本值		窗口标题。 可使用通配符，如“?”或“*”。
窗口	否	UI 元素		窗口 UI 元素
窗口实例	否	数值		要检查的窗口的实例或句柄
Window class	是	文本值		如果两个窗口标题相同，窗口类可以帮助区分它们。 在此情况下，请输入要使用的窗口类
Wait for window to	不适用	打开、关闭、成为焦点、失去焦点	待处理	是否等待特定窗口打开、关闭、成为焦点(即成为前景窗口)或失去焦点(即停止成为前景窗口)。
Focus window after it opens	不适用	布尔值	假	窗口打开后将其置于前端，以便后续操作指向此窗口

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法聚焦窗口	指示聚焦指定窗口时遇到问题
等待窗口失败	指示等待操作失败
无法在非交互模式下执行与窗口相关的操作	指示在非交互模式下执行窗口相关操作时遇到问题