对保存文件对话框进行处理
动词：handleSaveFileDialog
可从以下位置获取: <Standard>
通过将文件保存在给定目录中来处理保存文件对话框。
语法
handleSaveFileDialog --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”。 |
示例
示例 1：此命令处理与在桌面上保存“记事本”文件的操作对应的对话框。
defVar --name window --type Window
defVar --name processId --type Numeric
defVar --name desktopPath --type String
launchWindow --executablepath "notepad.exe" window=value processId=processId
clickOnMenu --window ${window} --menupath "file\r\nsave"
getSpecialFolder --folder "Desktop" desktopPath=value
handleSaveFileDialog --filepath "${desktopPath}\\File.txt" --title "Save As"
logMessage --message "End\r\nFile path: ${desktopPath}\\File.txt" --type "Info""
示例 2：与上一个示例类似，不同之处在于此次使用快捷键激活要处理的对话框，并使用正则表达式查找该对话框。
defVar --name window --type Window
defVar --name processId --type Numeric
defVar --name desktopPath --type String
launchWindow --executablepath "notepad.exe" window=value processId=processId
keyboard --type "KeyPress" --key "ControlKey"
keyboard --type "KeyDown" --key "S"
keyboard --type "KeyUp" --key "ControlKey"
getSpecialFolder --folder "Desktop" desktopPath=value
handleSaveFileDialog --filepath "${desktopPath}\\File.txt" --useregex --regexPattern "(Sa?v?e?)" --regexOptions "IgnoreCase, Multiline" --byparent
// handle the Dialog Box and save the file on the Desktop.
logMessage --message "\r\nFile path: ${desktopPath}\\File.txt" --type "Info"