ETABS二次开发入门（一）——简介

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，具体如下：

Member Name	Value
lb_in_F	1
lb_ft_F	2
kip_in_F	3
kip_ft_F	4
kN_mm_C	5
kN_m_C	6
kgf_mm_C	7
kgf_m_C	8
N_mm_C	9
N_m_C	10
Ton_mm_C	11
Ton_m_C	12
kN_cm_C	13
kgf_cm_C	14
N_cm_C	15
Ton_cm_C	16

再看另外一个函数调用：

ret = SapModel.LinkObj.GetNameList(ref numLink,ref linkName);

LinkObj也是一个Interface，GetNameList是其中一个函数，表示获取连接名称列表。ref表示参数按引用传递，这里numLink和linkName都由函数赋值，分别对应模型中连接个数和相应的名称列表，数据类型为int与string[]。

除了上述例子用到的Interfaces，ETABS API中还提供其他各种各样的Interfaces，比如获取分析结果的AnalysisResults（可以获取需要的分析结果，进行后处理、输出）、设置分析结果工况等信息的AnalysisResultsSetup以及各种单元的Interfaces等，这些在后续会相应提到。