启动或附加窗口
动词：launchOrAttach
将打开的窗口附加到执行上下文，或者在没有符合条件的打开的窗口时启动一个新窗口并将其附加到上下文。
语法
launchOrAttach --executablepath(String) [--parameters(String)] [--useregex(Boolean)] [--title(String)] --regexPattern(String) [--regexOptions(DisplayableRegexOptions)] [--id(String)] [--classname(String)] [--processid(Numeric)] [--processname(String)] [--byparent(Boolean)] [--window(Window)] [--recursive(Boolean)] [--safesearch(Boolean)] [--styles(Nullable<AutomationWindowStyles>)] [--minimumheight(Numeric)] [--minimumwidth(Numeric)] [--timeout(TimeSpan)] (Window)=value (Numeric)=processId (Boolean)=success
输入
| 脚本 | 设计器 | 必需的 | AcceptedTypes | Description |
|---|---|---|---|---|
| --executablepath | 可执行文件路径 | 必需的 | 文本 | 尚未打开任何窗口时应启动的可执行文件的路径。 |
| --parameters | 参数 | 可选 | 文本 | 启动可执行文件时使用的命令行参数。 |
| --useregex | 使用正则表达式 | 可选 | BOOLEAN | 使用时，会启用正则表达式以查找应附加到上下文的窗口。 |
| -- 标题 | 标题 | 可选 | 文本 | 应附加到上下文的窗口的标题。 |
| --regexPattern | 正则表达式 | 仅当“使用正则表达式”为 True 时 | 文本 | 用于识别应附加到上下文的窗口的正则表达式。 |
| --regexOptions | 选项 | 可选 | 可显示的正则表达式选项 | 正则表达式匹配的选项。 |
| --titleAsRegex | 标题是正则表达式（已废弃） | 可选 | BOOLEAN | 启用后，将允许使用“正则表达式”而不是窗口标题。此参数已废弃，应改为使用使用正则表达式参数。 |
| --ignorecase | 忽略大小写（已废弃） | 可选 | BOOLEAN | 启用后，将指定不区分大小写的匹配。此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| --dotmatchesnewline | 点与换行符匹配（已废弃） | 可选 | BOOLEAN | 启用后，点 (.) 字符匹配每个字符，而不是除“\n”之外的每个字符。此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| --freespacing | 忽略空格（已废弃） | 可选 | BOOLEAN | 启用后，将消除空格和换行符，而无需添加转义字符。此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| --explicitcapture | 显式捕获（已废弃） | 可选 | BOOLEAN | 启用后，指定唯一有效的捕获是显式命名或编号的组，格式为 (?此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| --multiline | 多行（已废弃） | 可选 | BOOLEAN | 启用后，将更改 ^ 和 $ 的含义，使其分别在任何行的开头和结尾匹配，而不仅仅在整个字符串的开头和结尾匹配。此参数已废弃。 要选择正则表达式选项，请改为使用选项。 |
| -- 标识 | 标识 | 可选 | 文本 | 应附加到上下文的窗口的标识。 |
| --classname | 类名 | 可选 | 文本 | 应附加到上下文的窗口的类名。使用记录器可获取此信息。 |
| --processid | 流程标识 | 可选 | 成员 | 窗口所属的进程的标识。 |
| --processname | 进程名称 | 可选 | 文本 | 窗口所属的进程的名称。 |
| --byparent | 在附加的窗口中搜索 | 可选 | BOOLEAN | 使用时，可从父窗口搜索子窗口。 |
| --window | 窗口 | 可选 | 窗口 | 应访存其子窗口的主窗口。 |
| --recursive | 递归 | 可选 | BOOLEAN | 启用后，将允许查找窗口中的窗口。 |
| --safesearch | 安全搜索 | 可选 | BOOLEAN | 使用时，将执行性能更好的搜索算法。 |
| --styles | 样式 | 可选 | AutomationWindowStyles | 应找到的窗口的窗口样式。 |
| --minimumheight | 最小高度 | 可选 | 成员 | 应找到的窗口的最小高度。 |
| --minimumwidth | 最小宽度 | 可选 | 成员 | 应找到的窗口的最小宽度。 |
| --timeout | 超时 | 可选 | 时间范围、数字、文本 | 命令执行超时。如果没有为超时参数定义任何值，那么执行将使用设置超时命令所定义的上下文超时。 如果脚本中未使用该命令，那么缺省超时为 5 秒。 |
输出
| 脚本 | 设计器 | AcceptedTypes | Description |
|---|---|---|---|
| 值 | 窗口 | 窗口 | 返回找到或启动的窗口。 |
| processId | 流程标识 | 成员 | 返回找到或启动的窗口的进程标识。 |
| 成功 | 成功 | BOOLEAN | 如果成功启动或附加窗口，那么返回“True”；如果未成功，那么返回“False”。 |
示例
使用启动或附加窗口命令查找打开的“记事本”窗口，同时使用标题对其进行识别并将其附加到执行上下文。 如果未识别任何窗口，那么会启动一个新的“记事本”窗口。 启动或找到的窗口存储在 notepadWindow 变量中。
defVar --name notepadWindow --type Window
defVar --name success --type Boolean
launchOrAttach --executablepath "notepad.exe" --title "Untitled - Notepad" notepadWindow=value success=success
logMessage --message "${success}" --type "Info"
// Launches a Notepad window or attaches an already open one to the context, then shows success or failure of execution in the console.