SIEMENS西门子黑龙江省伊春市（授权）伺服电机一级代理商——西门子东北总代理

1Eplan脚本的作用

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

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

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

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

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

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

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

脚本中我们可以使用如下所有的类：您不能在脚本（.Net Framework、EPLAN 或其他提供程序）中引用其他程序集。 脚本中不引用上述的程序集也可以使用。默认都是引用的。

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

2一、简单的脚本结构

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

public class <ScriptName>
{
     [Start]
     public void <FunctionName>
     {
           //<Enter your code text here>
           return;
     }
}
案例：弹窗using System.Windows.Forms;
namespace EplanScript
{
    public class GkpMessageBox
    {
        [Start]
        public void Function()
        {
            MessageBox.Show("你好","弹窗提醒"); 
            return;
        }
    }
}

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

3二、带参数的简单脚本

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

W3u.exe ExecuteScript /ScriptFile:<Value> /Param:<Value>

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