本节展示了如何在C#中创建一个EPLAN插件。为了说明安装.NET Framework已经提供了所有必要的工具(如C#编译器等),该插件并不是作为一个Visual Studio项目创建的,而是简单地使用文本编辑器和.NET Framework的命令行工具。

开始:

首先,创建一个目录来存储你的插件源代码是很有用的。在这个例子中,我们创建一个名为“SimpleCSharpAddIn”的文件夹。 现在启动你喜欢的文本编辑器,例如记事本,并开始编写源代码。

创建模块类:

每个EPLAN插件,包括我们将要创建的C#插件,都需要一个特定的类来管理该插件。这个类必须实现IEplAddIn接口声明的函数:

public class AddInModule: Eplan.EplApi.ApplicationFramework.IEplAddIn
{
        public bool OnRegister(ref System.Boolean bLoadOnStart)
        {
              bLoadOnStart=true;
             return true;
        }
        public bool OnUnregister()
        {
              return true;
        }
        public bool OnInit()
        {
              return true;
        }
        public bool OnInitGui()
        {
              return true;
        }
        public bool OnExit()
        {
              return true;
        }
}         

现在将这个源代码保存到文件夹 "SimpleCSharpAddIn" 中,文件名为 "AddInModule.cs"。

编译程序集(DLL)

现在是时候使用C#编译器了。编译器位于 .NET Framework 的目录中,例如 C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727。这个文件夹应该在搜索路径中。打开你喜欢的命令行工具并切换到你刚刚保存 "AddInModule.cs" 的 "SimpleCSharpAddIn" 目录。

使用以下参数运行C#编译器(csc.exe):

txt

csc /target:library /reference:..\\..\\..\\..\\bin\\Eplan.EplApi.AFu.dll /out: EPLAN.EplAddin.SimpleCSharp.dll AddinModule.cs

这些参数的含义是什么?

如果编译过程中没有出错,现在你会在 "SimpleCSharpAddIn" 文件夹中找到DLL "EPLAN.EplAddin.SimpleCSharp.dll"。将此文件复制到EPLAN平台的 bin 文件夹中。

d) 在EPLAN中加载一个插件

现在启动EPLAN。如果以下系统扩展在EPLAN中加载(通常应该是这样):EplanEplApiModuleu.erx, EplanEplApiModuleGUIu.erx。