查找多个窗口
动词:findWindows
查找符合定义条件的打开的窗口。
语法
findWindows [--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)] (List<Window>)=value
输入
| 脚本 | 设计器 | 必需的 | AcceptedTypes | 描述 |
|---|---|---|---|---|
| --useregex | 使用正则表达式 | 可选 | BOOLEAN | 启用后,将使用正则表达式查找窗口。 |
| --title | 标题 | 可选 | 文本 | 应找到的窗口的标题。 |
| --regexPattern | 正则表达式 | 仅当“使用正则表达式”为 True 时 | 文本 | 用于识别应找到的窗口的正则表达式。 |
| --regexOptions | 选项 | 可选 | DisplayableRegexOptions | 正则表达式匹配的选项: |
| --titleAsRegex | 标题是正则表达式(已废弃) | 可选 | BOOLEAN | 启用后,将允许使用“正则表达式”搜索窗口标题。此参数已废弃,应改为使用使用正则表达式参数。 |
| --ignorecase | 忽略大小写(已废弃) | 可选 | BOOLEAN | 启用后,将指定不区分大小写的匹配。此参数已废弃。 要选择正则表达式选项,请改为使用选项。 |
| --dotmatchesnewline | 点与换行符匹配(已废弃) | 可选 | BOOLEAN | 启用后,点 (.) 字符匹配每个字符,而不是除“\n”之外的每个字符。此参数已废弃。 要选择正则表达式选项,请改为使用选项。 |
| --freespacing | 忽略空格(已废弃) | 可选 | BOOLEAN | 启用后,将消除空格和换行符,而无需添加转义字符。此参数已废弃。 要选择正则表达式选项,请改为使用选项。 |
| --explicitcapture | 显式捕获(已废弃) | 可选 | BOOLEAN | 启用后,指定唯一有效的捕获是显式命名或编号的组,格式为 (?此参数已废弃。 要选择正则表达式选项,请改为使用选项。 |
| --multiline | 多行(已废弃) | 可选 | BOOLEAN | 启用后,将更改 ^ 和 $ 的含义,使其分别在任何行的开头和结尾匹配,而不仅仅在整个字符串的开头和结尾匹配。此参数已废弃。 要选择正则表达式选项,请改为使用选项。 |
| --id | 标识 | 可选 | 文本 | 应找到的窗口的标识。 |
| --classname | 类名 | 可选 | 文本 | 应找到的窗口的类名。使用记录器可获取此信息。 |
| --processid | 进程标识 | 可选 | 成员 | 窗口所属的进程的标识。 |
| --processname | 进程名称 | 可选 | 文本 | 窗口所属的进程的名称。 |
| --byparent | 在附加的窗口中搜索 | 可选 | BOOLEAN | 启用后,将允许搜索子窗口。 |
| --window | 窗口 | 可选 | 窗口 | 应找到其子窗口的主窗口。 |
| --recursive | 递归 | 可选 | BOOLEAN | 启用后,将允许查找窗口中的窗口。 |
| --safesearch | 安全搜索 | 可选 | BOOLEAN | 启用后,将执行性能更好的窗口搜索算法。 |
| --styles | 样式 | 可选 | AutomationWindowStyles | 应找到的窗口的样式。 |
| --minimumheight | 最小高度 | 可选 | 成员 | 应找到的窗口的最小高度。 |
| --minimumwidth | 最小宽度 | 可选 | 成员 | 应找到的窗口的最小宽度。 |
输出
| 脚本 | 设计器 | AcceptedTypes | 描述 |
|---|---|---|---|
| 值 | Windows | 列表<Window> | 返回找到的窗口的列表。 |
示例
使用查找窗口命令查找“记事本”窗口,使用项计数命令指定找到的窗口的数量。
defVar --name foundedWindows --type List --innertype Window
defVar --name windowsQuantity --type Numeric
launchWindow --executablepath "notepad.exe"
launchWindow --executablepath "notepad.exe"
findWindows --classname Notepad foundedWindows=value
// Find open Notepad windows and store them in a list.
count --collection "${foundedWindows}" windowsQuantity=value
// Counts the number of windows found and displays the result in the console.
logMessage --message "Windows Quantity: ${windowsQuantity}" --type "Info"