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

再看另外一个函数调用：

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