ETABS是一款常用的结构设计软件，能够实现快速建模、分析等功能。这里以ETABS 2015为例，阐述利用ETABS API进行二次开发的方法。
文章的主要参考文献为ETASB自带的CSi API ETABS 2015.chm，结合自身开发实例进行说明。
先看一个简单的C#例子，用于获取模型的连接（link）数目和名称。
using ETABS2015;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using System.Reflection;
namespace PostProcess
{
public class cPlugin
{
public void Main(ref ETABS2015.cSapModel SapModel, ref ETABS2015.cPluginCallback ISapPlugin)
{
//Create By Ron-Wang
//用于获取API函数调用的返回值，若为0则调用成功
int ret = 0;
//用于设置模型的单位制
ret = SapModel.SetPresentUnits(eUnits.kN_m_C);
//连接数
int numLink = 0;
//连接名称
string[] linkName = null;
//获取连接信息
ret = SapModel.LinkObj.GetNameList(ref numLink,ref linkName);
//弹窗
if (ret != 0)
MessageBox.Show("获取连接失败！");
else
{
if (numLink > 0)
MessageBox.Show("有" + numLink + "个连接");
else
MessageBox.Show("无连接");
}
}
}
}
上述例子中，首先应该添加ETABS2015引用。这里的PostProcess是命名空间，注意插件开发的类名必须是cPlugin（也可以编程实现外部调用，后面会说到）！！Main主函数，参数可以先不管。
API中的函数要用SapModel（本身就是一个Interface）进行调用，例如第一个：
ret = SapModel.SetPresentUnits(eUnits.kN_m_C);
表示模型设置单位制为kN-m-C，ret是函数的返回值，若为0则表示调用成功。eUnits是API中定义的一个Enumeration，具体如下：
再看另外一个函数调用：
ret = SapModel.LinkObj.GetNameList(ref numLink,ref linkName);
LinkObj也是一个Interface，GetNameList是其中一个函数，表示获取连接名称列表。ref表示参数按引用传递，这里numLink和linkName都由函数赋值，分别对应模型中连接个数和相应的名称列表，数据类型为int与string[]。
除了上述例子用到的Interfaces，ETABS API中还提供其他各种各样的Interfaces，比如获取分析结果的AnalysisResults（可以获取需要的分析结果，进行后处理、输出）、设置分析结果工况等信息的AnalysisResultsSetup以及各种单元的Interfaces等，这些在后续会相应提到。
谢谢您的阅读与支持！
文章内容原创，如需转载或内容合作，请联系作者：wangrongxin168@163.com
