《Eplan API程序设计》是一本专注于EPLAN电气工程软件API开发的技术书籍，深入讲解如何利用API进行自动化编程和二次开发。适合电气工程师和技术人员阅读学习。
Eplan API 编程指南
Eplan API 提供了一种强大且灵活的编程接口，允许开发人员构建复杂的自动化解决方案以满足不同行业的特定需求。本段落档将介绍 Eplan API 编程中的一些关键功能，并提供一个基本的 Add-In 项目示例，展示了如何创建 Add-In、加载 Action 和添加菜单项等操作。
一、创建 Add-In
在Eplan API编程中，第一步是创建Add-In。这包括建立一个新的类库项目，并且需要为这个项目添加特定的工程引用。具体来说，在 Eplan P82.0.5BIN 目录下，你需要加入三个文件作为引用：Eplan.EplApi.AFu.dll、Eplan.EplApi.Baseu.dll 以及 Eplan.EplApi.Systemu.dll。有时为了使程序集能够正确地引用这些库文件，你可能还需要在 App.Config 文件中进行相应的配置。
二、Action说明
Action是构建自动化解决方案的核心组件之一，在Eplan API编程中扮演着重要角色。一个 Action 可以通过命令行或者菜单来调用，并且可以覆盖现有同名的 Action。每个 Action 都有一个类来进行执行，这个类需要继承自接口 IEplAction<1>。
在 Add-In 中管理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;
}
}
添加一个 Action 类使用 Eplan.EplApi.ApplicationFramework 名称空间。下面是一个示例：
public class CSharpAction: IEplAction
{
//当执行时调用的方法
public bool Execute(ActionCallingContext ctx)
{
System.Windows.Forms.MessageBox.Show(CSharpAction was called!);
return true;
}
//注册 Action 的名称和顺序号
public bool OnRegister(ref string Name, ref int Ordinal)
{
Name = CSharpAction;
Ordinal = 20;
return true;
}
//设置描述信息
public void GetActionProperties(ref ActionProperties actionProperties)
{
actionProperties.Description= Action test with parameters.;
}
}
三、在 Eplan 中装载
要在Eplan中加载 Add-In，你需要创建一个新的Add-In项目，并添加对 Eplan.EplApi.AFu.dll, Eplan.EplApi.Baseu.dll 和 Eplan.EplApi.Systemu.dll 的引用。然后，在这个新项目的类库中加入新的类并继承 IEplAction<1> 接口。
四、通过命令行调用关闭Eplan
在命令行里进入 W3u.exe 所在的目录，执行 W3u.exe CSharpAction 命令可以启动 Eplan 并运行上面定义的函数。
五、添加菜单项
为了向 Eplan 添加一个新菜单项，你需要引用Eplan.EplApi.Guiu.dll。然后，在 public bool OnInitGui() {} 方法中加入以下代码：
Eplan.EplApi.Gui.Menu oMenu = new Eplan.EplApi.Gui.Menu();
oMenu.AddMenuItem(CSharpActionMenu, CSharpAction);
这将在“Utilities”菜单里添加一个名为CSharpActionMenu的项，当用户点击这个选项时，会调用之前定义好的 CSharpAction 函数。
Eplan API 编程提供了强大的编程接口来创建复杂的自动化解决方案。通过本段落档所介绍的基本概念和使用方法，你可以进一步学习并实践 Eplan API 编程以满足不同的行业需求。
5星
