SIEMENS广东省东莞市-西门子代理(授权)一级总代理

1Eplan脚本的作用

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

• 借助脚本可一次运行一个功能。
• 通过调用命令行来启动脚本。可以让我们给脚本传送更多的参数。
• 通过脚本自动执行EPLAN的操作。
• 通过脚本来读取或修改设置setting。
• 通过脚本给 EPLAN 添加新操作。在此过程中，可以将新操作作为命令集成到功能区中。
• 脚本也可对 EPLAN 的事件做出反应。如对程序启动或退出做出反应。

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

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

2一、简单的脚本结构

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

public class <ScriptName>
{
[Start]
public void

案例：弹窗

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:

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

案例：带参数的脚本

using System.Windows.Forms;
using Eplan.EplApi.Scripting;
namespace EplanScript
{
public class GkpScriptWithParameter
{
[Start]
public void Main(string title,string content,string header)
{
MessageBox.Show(header + content, title);

// return;//不写返回有问题吗？可以
}
}
}

执行脚本：

.\W3u.exe ExecuteScript /ScriptFile:"C:\Users\Joygen.Zhang\RiderProjects\EplanScript\EplanScript\GkpScriptWithParameter.cs" /title:弹窗 /content:内容 /header:标题

运行效果如下所示：

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

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

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

public class <ScriptName>
{
[Start]
public void

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

5四、读写设定的脚本

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

这个不适用于项目设定

在读出设置之前，您必须找到设置的名称。为此，请使用以下C#脚本打开隐藏菜单：

using Eplan.EplApi.Scripting;

namespace EplanScript
{
public class GkpScriptRWSetting
{
[Start]
public void RWSetting()
{
Eplan.EplApi.Base.Settings oSettings = new Eplan.EplApi.Base.Settings();
oSettings.SetBoolSetting("USER.EnfMVC.ContextMenuSetting.ShowExtended", true, 0);
}
}
}

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