EPLAN脚本从入门到应用-3《HelloWorld》 点击:1628 | 回复:2



gongkong_shb

    
  • 精华:0帖
  • 求助:0帖
  • 帖子:4帖 | 8回
  • 年度积分:12
  • 历史总积分:173
  • 注册:2008年7月09日
发表于:2019-08-29 15:06:00
楼主


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

 

丨教程丨EPLAN脚本从入门到应用-3


 
出品丨电气CAD论坛

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

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

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

3.3

第一个脚本程序:Hello,World


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

工具菜单:脚本>执行...

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

丨教程丨EPLAN脚本从入门到应用-3

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

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脚本从入门到应用-3

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脚本从入门到应用-3

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


公众号
微信号





FEI022688

  • 精华:0帖
  • 求助:1帖
  • 帖子:2帖 | 362回
  • 年度积分:0
  • 历史总积分:63
  • 注册:2011年3月29日
发表于:2019-11-29 09:53:14
1楼

太高大上了,俺学不会

  • 精华:0帖
  • 求助:0帖
  • 帖子:0帖 | 34回
  • 年度积分:0
  • 历史总积分:92
  • 注册:2007年4月30日
发表于:2019-12-21 11:20:41
2楼

俺看的也是迷迷糊糊


热门招聘
相关主题

官方公众号

智造工程师