本文是对HFSS Scripting Guide文档中Introduction to VBScript部分的理解性翻译,如有错误,欢迎大佬们批评指正,感谢!!!
HFSS使用the Microsoft Visual Basic Scripting Edition(VBScript)脚本语言来记录宏指令。用脚本程序可以很快很有效的完成你想重复的任务。你可以用任何文本编辑器编写脚本,也可以在HFSS界面内编写。在HFSS内编写之后,如果有必要你可以在一个文本编辑器中修改它。
虽然HFSS以VBScript形式编写脚本,但也可以以JavaScript形式运行。如果使用命令提示符运行脚本,脚本可以用任何提供the Microsoft COM方法的语言编写。HFSS脚本文档仅涉及VBScript格式。
1.HFSS脚本的一个示例
下面是HFSS脚本的一个例子。它包含以引号(')或单词REM开头的注释行,以对前面一行或多行提供解释。
'----------------------------------------------
'Script Recorded by Ansoft HFSS Version 10.0
'----------------------------------------------
Dim oDesign
Dim oEditor
Dim oModule
Set oAnsoftApp = CreateObject("Ansoft.ElectronicsDesktop")
Set oDesktop = oAnsoftApp.GetAppDesktop()
oDesktop.NewProject
Set oProject = oDesktop.GetActiveProject
oProject.InsertDesign "Hfss", "HFSSDesign1", "DrivenModal", ""
Set oDesign = oProject.SetActiveDesign("HFSSDesign1")
Set oEditor = oDesign.SetActiveEditor("3D Modeler")
oEditor.CreateBox Array("NAME:BoxParameters", "XPosition:=", _
"0mm", "YPosition:=", "0mm", "ZPosition:=", "0mm", _
"XSize:=", "1.6mm", "YSize:=", "1.2mm", "ZSize:=", _
"0.8mm"), Array("NAME:Attributes", "Name:=", "Box1", "Flags:=", _
"", "Color:=", "(132 132 193)", "Transparency:=", _
0.400000005960464, "PartCoordinateSystem:=", _
"Global", "MaterialName:=", "vacuum", "SolveInside:=", true)
①Dim用来声明变量,Dim指dimension。在VBScript中你可以用Dim、Public和Private来声明变量。由于VBScript没有内置数据类型(如REM整数、字符串等),所有的变量均被视为变体,能够存储任意类型的REM信息。在这个例子中,有三个变量将被用为对象。当用REM在HFSS 中编写脚本时,被用作对象的变量总是以o开头的。
②你可以用Set将对象引用分配给变量。对象的副本并不是为该变量创建的。CreateObject是一个将字符串作为输入并返回对象的函数。此对象被分配给oAnsoftApp变量。
③GetAppDesktop是oAnsoftApp的一个函数。此函数不需要输入并且返回一个对象。返回的对象被分配给oDesktop变量。
④在VBScript中,子程序是用名称来调用的,可以接收参数并且可以用一组语句执行特定的任务。这里对象oDesktop的子程序NewProject被调用,此程序没有采用输入。
⑤在子程序或函数调用中,你可以将输入参数放入括号中,也可以不用括号。这里四个字符串是oProject对象InsertDesign子程序的输入参数。
⑥oEditor.CreateBox是采用两个数组变量作为输入的子程序。第一个数组是长方体的几何参数,第二个数组是长方体的属性。你可以通过修改条目来创建一个不同的长方体。在VBScript中,Array是一个函数,它返回一个包含数组的变量。
⑦下划线(_)指语句在下一行继续。下划线字符必须放在字符串常量之外,否则VBScript将把下划线认为是字符常量的一部分。字符串过长时可使用&:
’Msgbox("Please include units when creating variables " & _
"that require dimensions."