控制台
控制台是引擎自己用于诊断和试用的窗口。它显示引擎报告的内容(配置中的问题、失败的脚本、回退到内置绘制的插件),显示您的脚本打印的内容,并提供一个可以当场编写和运行脚本的编辑器。
打开控制台
从托盘菜单中选择 显示控制台(托盘图标),或者从操作中运行 UIShowConsole 内置函数——例如将其绑定到热键。除非您通过 收到消息时(见下文)要求,否则不会自动打开控制台。
如果您的配置受密码保护,控制台打开时会要求输入密码,除非仍记住密码(安全)。控制台打开期间,记住的密码不会过期。UIShowConsole 会一直等到控制台打开(包括询问密码期间),如果控制台没有打开(例如取消了密码提示),则返回 false。
使用控制台的关闭按钮关闭它。关闭会释放它所使用的内存。
三个部分
顶部的按钮 ① 用于在三个部分之间切换,每个部分都有自己的工具栏。
| 部分 | 显示的内容 | 工具栏 |
|---|---|---|
| 系统 | 引擎报告的内容:上次加载时关于您配置的通知、失败的操作和脚本及其原因、无法绘制而改由内置绘制接管的插件等。 | 复制、清除、收到消息时 |
| 用户 | 您的脚本通过 UtilityPrint 打印的所有内容,来自所有操作。 | 复制、清除、收到消息时 |
| 脚本 | 位于输出窗格上方的脚本编辑器。 | 执行、全部停止、隐藏控制台、脚本帮助、复制、粘贴、清除 |
复制 会复制所选文本;如果未选择任何内容,则复制整个部分。清除 会清空该部分。
显示 脚本 部分时,新的 系统 和 用户 行也会出现在其输出窗格中,因此您无需切换部分即可观察正在运行的脚本。
控制台关闭期间
控制台关闭期间到达的行不会丢失:它们会保存在临时文件中,并在您下次打开控制台时显示。Input.Observer 退出时这些内容会被删除,但 引擎正在关闭 事件打印的内容除外,它会显示在下一个会话的控制台中。
系统 和 用户 工具栏上的 收到消息时 ① 用于选择控制台关闭期间新行到达时的处理方式:
| 选项 | 会发生什么 |
|---|---|
| 不执行任何操作 | 该行会等到您打开控制台时显示。这是默认值。 |
| 显示 UIShowMessageBox | 该行还会在消息框中弹出。 |
| 打开控制台 | 控制台会在该部分打开。 |
控制台打开时,新行只会被添加;它永远不会弹出消息框或切换部分。控制台 页面上的 新的系统消息 和 新的用户消息 提供相同的选项。
运行脚本
- 打开控制台的 脚本 部分。
- 在编辑器中键入或粘贴脚本。它使用 Input.Observer 的脚本语言(脚本语言)。
- 选择 执行 ② 或按 F5。选中文本时只运行所选内容;否则运行整个编辑器中的内容。
- 输出和任何错误会显示在编辑器下方的输出窗格中。隐藏控制台 用于隐藏或显示该窗格。
- 在这里运行的脚本与操作的工作方式相同:所有内置函数都可用,并且它会一直运行到完成或被停止。全部停止 会停止所有正在运行的脚本和操作,而不仅仅是这一个。
- 这是安全模式下唯一可以运行脚本的地方,因此您可以在其他内容都不运行的情况下进行检查和修复(故障排除)。
- 编辑器会在您键入时补全内置函数名称;Ctrl+Space 会列出所有内容,键入领域名称和句点会列出该领域的内置函数。选择内置函数后,会有提示显示其参数,并突出显示当前参数。右键菜单中有针对所选行的 注释 和 取消注释。
- 编辑器中的文本会保存在
console.toml中,在会话之间保留。
脚本帮助 ③ 会在帮助窗口(帮助窗口)中打开脚本语言参考,使用 Input.Observer 所用的语言(如果没有该语言的帮助,则使用英语)。
“控制台”页面
高级模式。 控制台 页面在简单模式下会被隐藏。其设置仍然有效。
配置窗口中的 控制台 页面包含控制台的设置。它们在您选择 应用 或 保存并关闭 时生效。
| 设置 | 作用 | 默认值 | 范围 |
|---|---|---|---|
| 控制台行数限制 | 某个部分的行数达到此值后,每到达新行就丢弃最旧的行。0 表示全部保留。从下一行开始生效。 | 5000 行 | 0–1000000 |
| 关闭控制台时释放内存 | 关闭控制台后立即将其内存归还给 Windows。之后的下一个鼠标或键盘事件可能会略微变慢。 | 打开 | 打开或关闭 |
| 新的系统消息 | 控制台关闭期间新的 系统 行到达时的处理方式:不执行任何操作、消息框 或 打开控制台(与上文的 收到消息时 相同) | 不执行任何操作 | — |
| 新的用户消息 | 对 用户 行的相同设置 | 不执行任何操作 | — |
| 引擎窗口字体 | 控制台的标签和按钮以及引擎对话框(密码、许可证)所用的字体和大小 | Segoe UI,12 磅 | 6–72 磅 |
| 引擎编辑器字体 | 控制台各部分及其脚本编辑器所用的字体和大小 | Consolas,13 磅 | 6–72 磅 |
已打开的控制台会保持其字体,直到您关闭后重新打开它。