06 · 脚本与程序集

画面和数据搭好后,复杂逻辑靠脚本。脚本用 C#(带易语言式界面简写),在程序集编辑器里写。程序集分两种:

  • 窗口程序集 —— 每张画面一个同名模块,写这张画面的进入/退出/元素事件脚本。
  • 全局程序集 —— 软件启动/退出脚本、全局条件脚本、全局周期脚本。

打开程序集编辑器

  • 工程树 窗口 → 窗口程序集 → 双击某模块 进该画面脚本;
  • 工程树 全局 → 全局程序集 进启动/退出/全局脚本;
  • 或工具菜单 → 程序集(全局脚本)。

【配图:程序集编辑器——左侧子程序列表,中间带语法高亮的代码区,底部诊断】


写脚本:C# + 界面简写

脚本是真 C#(Roslyn 编译),函数库以对象形式暴露,直接写 Tag.Read(...)、Log.Info(...) 就是调它们。函数库覆盖:

Tag  Log  Sys  Timer  Math2  Str  Bit  Fs
Alarm  History  Db  Ui  Comm  Report  Recipe

界面简写(易语言式):#窗口.组件.属性 = 值 写界面、变量 = #窗口.组件.属性 读界面;画面脚本里可省窗口名。


代码提示与高亮

  • C# 语法高亮 —— 关键字/字符串/注释着色。
  • 内联代码提示 —— 敲一半弹出补全候选(函数 / 点 / 变量),回车/Tab 补上。
  • 快速插入弹窗 —— 不记函数名时,弹窗按分类挑:函数 / 点 / 变量 / 界面(界面页:画面→组件→属性,自动拼成 #窗口.组件.属性)。
  • 提示面板 —— 光标停在某函数上,底部"提示"面板显示它的用法;双击函数名看用法详情。

编译校验(F7)

写完点编译按钮(或 F7)做编译校验:

  • 底部输出面板列出诊断(错误/警告),点一条能跳到出错位置。
  • 校验用的是真 Roslyn 编译器,和最终编译同一套,不是假检查。

运行菜单里还有编译 / 快速编译、校验工程(整工程一起校验)。


全局查找 / 替换

编辑菜单 → 查找(脚本 / 元件文本 / 变量):

  • 跨整个工程搜脚本代码、元件文本、变量名。
  • 全局替换:只改脚本代码,字面量区分大小写,批量写回前用确认框拦一下(避免误改一片)。

函数库目录

快速插入弹窗和提示里的函数清单来自后端函数目录(不是写死的),覆盖标签/日志/系统/定时/数学/文本/时间/转换/异常/位运算/文件等多个库,每条带用法 Hint。


一句话总结

脚本用 C# + #窗口.组件.属性 界面简写,在程序集编辑器里写(窗口程序集分画面、全局程序集管启停/条件/周期);带语法高亮、内联补全、快速插入弹窗、光标跟随提示;F7 编译校验用真 Roslyn、诊断可跳错;全局查找替换跨工程改脚本。