Eplan2022 C#脚本入门：开启自动化设计之旅

1Eplan脚本的作用

EPLAN 脚本为您提供下列功能：

• 借助脚本可一次运行一个功能。

• 通过调用命令行来启动脚本。可以让我们给脚本传送更多的参数。

• 通过脚本自动执行EPLAN的操作。

• 通过脚本来读取或修改设置setting。

• 通过脚本给 EPLAN 添加新操作。在此过程中，可以将新操作作为命令集成到功能区中。

• 脚本也可对 EPLAN 的事件做出反应。如对程序启动或退出做出反应。

脚本中我们可以使用如下所有的类：

如果需要[Start]不标记红色，需要引入Eplan.EplApi.AFu 程序集，然后添加using Eplan.EplApi.Scripting;::: 执行自动编辑（也就是执行自动操作）

2一、简单的脚本结构

您可以执行的简单脚本至少包含一个具有至少一个函数的公共类。此函数始终必须用 [Start] 属性标记。 一个简单的 C# 脚本的整体结构如下所示：

案例：弹窗

在此示例中，生成了具有函数 Function的类 GkpMessageBox。该函数由[Start]属性标记。如果脚本是通过命令路径文件>附加>接口>脚本>运行的，则会出现你好的弹窗消息。效果如下：

3二、带参数的简单脚本

脚本功能也接受参数。但是，这只有在脚本启动时将 /Param 参数传输到脚本时才有意义。这可以通过使用命令行调用EPLAN来实现：

执行方式C:\Program Files\EPLAN\Electric P8\2022.0.3\Bin

案例：带参数的脚本

执行脚本：

运行效果如下所示：

注意：不能遗漏/ScriptFile:否则会报错

4三、带Eplan动作Action的简单脚本

您还可以选择将自动操作集成到一个简单的脚本中。使用这些 EPLAN 操作，您可以自动运行不同的程序功能（例如备份数据、打印等）。在类>[Start] 特征和方法之后，您必须在脚本中为操作指定参数集，然后通过CommandLineInterpreter ().Execute() 运行操作。这样一个简单的 C# 脚本的整体结构如下所示：

注意：使用AddParameter方法，程序中必须添加Eplan.EplApi.Baseu 的引用。

5四、读写设定的脚本

可以使用简单的脚本从设置对话框中读取和更改设置。

这个不适用于项目设定

执行脚本后，首先必须重新启动 EPLAN。用于复制到剪贴板的设置路径弹出菜单项随后在设置对话框中可用。右键点击运行设置的弹出菜单项并将名称复制到剪贴板。这是显示用户界面颜色的名称USER.MF.GuiColorScheme。然后您可以在脚本中使用该名称来更改或读出相应的设置。