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

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

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

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

当你有时候心里有个念头时,即便不用刻意的做,也会从日常工作、生活中,在心里生根发芽,EPLAN脚本这个主题是在3个月前萌生的,至到今天,我想可以写出来和大家分享分享了,希望能得到大家的支持,并坚持将整个系列写下去!

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

知识点:
  1. 你的第一个脚本程序:Hello,World

3.3

第一个脚本程序:Hello,World

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

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

工具菜单:脚本>执行…

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

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

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

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调出。

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

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

B.Class.Function();

public class Class

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

[Start]

[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多种方法的重载,我们可以在提示框中分别去查看它所必需的参数变量:

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

最后由于Function声明为void无参数返回,所以通过语句return;结束程序的执行。本程序的源代码可通过电气CAD论坛或3D大学登陆后下载。
至此我们的第一个脚本文件Hello World就编写完了。我们来总结一下:一个最基本的显示对话框脚本至少要引用两个组件,程序中要最少包含一个public公共的Class和[Start]执行特性,最后需要通过return返回,以结束脚本的运行。通过本节你可以看到脚本是通过点击EPLAN中的菜单手动单次执行的,如果你想频繁的调用脚本,这个办法显然不是最好的,下节里我们介绍另一种特性,教大家如何加载脚本来多次调用。欢迎大家分享与关注!

免责声明,若由于商用引起版权纠纷,一切责任均由使用者承担。

您必须遵守我们的协议,如果您下载了该资源行为将被视为对《免责声明》全部内容的认可->联系站长投诉资源
电气CAD论坛资源大都来自原创,也有少部分来自互联网收集,仅供用于学习和交流,请勿用于商业用途。如有侵权、不妥之处,请联系站长并出示版权证明以便删除。敬请谅解! 侵权删帖/违法举报/投稿等事物联系邮箱:cad-bbs@qq.com
电气CAD论坛-EPLAN教程 ACE教程 » EPLAN脚本从入门到应用-5 《hello world》
微信公众号:电气CAD论坛
关注我们,获取更多的优质资源!
这里有2W+多个小伙伴已经关注了哦
分享到:
赞(3)

评论抢沙发

评论前必须登录!