EPLAN脚本从入门到应用-5 《hello world》

教程
EPLAN脚本从入门到应用-3《Hello World》

编辑丨石海波  出品丨电气CAD论坛

感谢大家的支持，上节我们将C#开发EPLAN脚本的环境已经搭建完毕，本节我们通过一个显示对话框的实例，对程序结构做一个了解，开始前先给大家讲个经典的笑话：某程序员对书法十分感兴趣，退休后决定在这方面有所建树。于是花重金购买了上等的文房四宝。一日，饭后突生雅兴，一番磨墨拟纸，并点上了上好的檀香，颇有王羲之风范，又具颜真卿气势，定神片刻，泼墨挥毫，郑重地写下：Hello world。

1. 你的第一个脚本程序：Hello,World

3.3

第一个脚本程序：Hello,World！

上面便是本节的源代码，你只需要复制到记事本或VS中新建的类文件中即可，保存为cs格式的文件后，启动EPLAN，执行刚才的脚本。

工具菜单：脚本>执行…

选择你的第一个脚本文件后，屏幕中心便会显示此对话框。

现在我们一行行来了解上面的代码。

using Eplan.EplApi.Scripting;
using System.Windows.Forms;

首先前两个using引用是必备的，分别包含了提供脚本运行功能和显示对话框功能。这里需要注意的是脚本中你除了引用EPLAN API Assemblies中的所有级别外，通常包括：

• Eplan.EplApi.ApplicationFramework 
• Eplan.EplApi.Base 
• Eplan.EplApi.Scripting

就只能引用以下4种windows系统的组件：

• Microsoft.Net Assemblies System
• System.XML
• System.Drawing
• System.Windows.Forms

而不能关联.Net Framework，EPLAN 或其它供应商的组件。

每一个类或方法的作用域或叫生命周期，并以左花括号｛ 为起始，右花括号 ｝为终止的，而每条语句是以分号；为结尾，在VisualStudio中编写代码会有自动提示，你也可以按Ctrl+J调出。

namespace是命名空间的声明，声明当前代码内的所有方法、属性是在Namespace空间下，这个主要用来解决不同文件下重名问题的，例如你有另一个程序文件，命名空间为：B，里面也包含一个Class类的Function方法，那在本代码中想调用它就可以这样写：

B.Class.Function();

public class Class

public是声明当前Class类为公共的等级，一个EPLAN脚本中，至少要有一个公共的等级组成，class 关键字用于声明一个类，类是面向对象编程语言中的一种抽象，这里不作为重点，就不展开了，大家可以自行百度了解下概念。你可以先简单理解成多种方法的集合。

[Start]执行特性，特性是用于在运行时传递程序中各种元素（比如类、方法、结构、枚举、组件等）的行为信息的声明性标签，[Start]特性是我们测试、执行脚本最为常用的特性，通常放在要执行函数的上方，除了[Start]执行外，后续我们还会了解到其它更多的特性：

• [DeclareAction]
• [DeclareEventHandler
• [DeclareMenu]
• [DeclareRegister]
• [DeclareUnregister]

public void Function()
    {
      MessageBox.Show("Hello,World!"); // 在EPLAN中显示一个对话框，显示Hello,World!
      return;
    }

最后一个是函数Function()的编写，public标明了此函数也是公共类型，void表示此函数无参数返回，而里面的命令MessageBox.Show()就是执行显示一个对话框的方法，它里面需要传递一个字符串类型的参数，所以我们需要用英文的双引号书写，除此外，MessageBox.Show还包括其它20多种方法的重载，我们可以在提示框中分别去查看它所必需的参数变量：