对打开文件对话框进行处理
动词：handleOpenFileDialog
可从以下位置获取: <Standard>
处理对话框，该对话框源自打开文件的操作。 将找到此对话框，然后通过此对话框打开指定文件。
语法
handleOpenFileDialog --filepath(String) [--useregex(Boolean)] [--title(String)] --regexPattern(String) [--regexOptions(DisplayableRegexOptions)] [--id(String)] [--processid(Numeric)] [--processname(String)] [--byparent(Boolean)] [--window(Window)] [--safesearch(Boolean)] [--timeout(TimeSpan)] (Window)=value (Numeric)=processId (Boolean)=success
输入
| 脚本 | 设计器 | 必需的 | AcceptedTypes | Description |
|---|---|---|---|---|
| -- 文件路径 | 文件路径 | 必需的 | 文本 | 对话框应打开的文件的完整路径。 |
| --useregex | 使用正则表达式 | 可选 | BOOLEAN | 启用后，将使用正则表达式找到对话框。 |
| -- 标题 | 标题 | 可选 | 文本 | 应处理以打开文件的对话框的标题。 |
| --regexPattern | 正则表达式 | 仅当“使用正则表达式”为 True 时 | 文本 | 用于基于其标题查找对话框的正则表达式。 |
| --regexOptions | 选项 | 可选 | 可显示的正则表达式选项 | 帮助执行正则表达式搜索的过滤选项： |
| --titleAsRegex | 标题是正则表达式（已废弃） | 可选 | BOOLEAN | 启用后，将允许使用“正则表达式”搜索窗口标题。此参数已废弃，应改为使用使用正则表达式参数。 |
| --ignorecase | 忽略大小写（已废弃） | 可选 | BOOLEAN | 启用后，将指定不区分大小写的匹配。此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| --dotmatchesnewline | 点与换行符匹配（已废弃） | 可选 | BOOLEAN | 启用后，点 (.) 字符匹配每个字符，而不是除“\n”之外的每个字符。此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| --freespacing | 忽略空格（已废弃） | 可选 | BOOLEAN | 启用后，将消除空格和换行符，而无需添加转义字符。此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| --explicitcapture | 显式捕获（已废弃） | 可选 | BOOLEAN | 启用后，指定唯一有效的捕获是显式命名或编号的组，格式为 (?此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| --multiline | 多行（已废弃） | 可选 | BOOLEAN | 启用后，将更改 ^ 和 $ 的含义，使其分别在任何行的开头和结尾匹配，而不仅仅在整个字符串的开头和结尾匹配。此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| -- 标识 | 标识 | 可选 | 文本 | 应处理以打开文件的对话框的标识 |
| --processid | 流程标识 | 可选 | 成员 | 操作系统任务管理器中与对话框关联的进程的标识。 |
| --processname | 进程名称 | 可选 | 文本 | 操作系统任务管理器中与对话框关联的进程的名称。 |
| --byparent | 在附加的窗口中搜索 | 可选 | BOOLEAN | 启用后，将搜索子窗口，即与父窗口关联的对话框，该父窗口会启动打开文件操作。 |
| --window | 父窗口 | 可选 | 窗口 | 用于搜索应处理以在其子窗口中打开文件的对话框的父窗口。 |
| --safesearch | 安全搜索 | 可选 | BOOLEAN | 启用后，将执行性能更好的搜索算法。 |
| --timeout | 超时 | 可选 | 时间范围、数字、文本 | 等待执行操作的最长时间如果没有为超时参数定义任何值，那么执行将使用设置超时命令所定义的上下文超时。 如果脚本中未使用该命令，那么缺省超时为 5 秒。 |
输出
| 脚本 | 设计器 | AcceptedTypes | Description |
|---|---|---|---|
| 值 | 对话窗口 | 窗口 | 从对话框窗口返回数据。 |
| processId | 流程标识 | 成员 | 返回操作系统的任务管理器中的进程标识，该进程标识与已处理以打开文件的对话框相关联。 |
| 成功 | 成功 | BOOLEAN | 如果已成功处理对话框，那么返回“True”；如果未成功，那么返回“False”。 |
示例
使用获取系统文件夹路径命令获取“我的文档”文件夹，然后使用写入文件命令创建将在“我的文档”中保存的文件。 然后，会打开“记事本”窗口，单击菜单中的“文件”>“打开”选项以打开对话框。 然后，使用对打开文件对话框进行处理命令，识别打开的对话框并选择之前创建的文件，以便在当前“记事本”窗口中将其打开。
defVar --name notepadWindow --type Window
defVar --name myDocumentsDirectory --type String
defVar --name fileDirectory --type String
defVar --name handleSuccess --type Boolean
// The "My Documents" folder path is obtained to save the file that will be created by the "Write to File" command, so that it can be manipulated by the "Handle Open File Dialog" command.
getSpecialFolder --folder "MyDocuments" myDocumentsDirectory=value
writeToFile --value "This file will be opened by the action of the \"Handle Open File Dialog Box\" command during the execution of the documentation script.\r\n" --file "${myDocumentsDirectory}\\file.txt" fileDirectory=value
// Open the Notepad so that, later, the "Handle Open File Dialog Box" command handles the dialog box that will open to obtain the created file.
launchWindow --executablepath "notepad.exe" notepadWindow=value
clickOnMenu --window ${notepadWindow} --menupath "file\r\nopen"
handleOpenFileDialog --filepath "${fileDirectory}" --title Open --safesearch --timeout 00:00:10 handleSuccess=success
logMessage --message "The dialog box has been successfully handled: ${handleSuccess}" --type "Info"