sap2000_api入門(mén)指南

1、北 京 金 土 木 軟 件 技 術(shù) 有 限 公 司Beijing Civil King Software Technology Co., Ltd.網(wǎng)址：www.bjcks.com www.archicad.net.cn 電話(huà)：010-88383866 傳真：010-88381056E-mail:info@bjcks.com (一般問(wèn)題); support@bjcks.com (技術(shù)支持); sales@bjcks.com (試用、購(gòu)買(mǎi)、

2、升級(jí))ac@bjck.com(ArchiCAD 一般問(wèn)題); acsupport@bjcks.com (ArchiCAD 技術(shù)支持)地址：北京首體南路 9 號(hào)主語(yǔ)國(guó)際 2 號(hào)樓 中國(guó)建筑標(biāo)準(zhǔn)設(shè)計(jì)研究院 郵編：1000481SAP2000 SAP2000 API API 入門(mén)指南 入門(mén)指南余承飛 韋群躍 湯娣概述 概述SAP2000 API 是從 SAP2000 V11 開(kāi)始引進(jìn)的，即應(yīng)用軟件編程接口。用戶(hù)可以編寫(xiě)程序，通過(guò) API 隨心

3、所欲地調(diào)用 SAP2000 的內(nèi)部功能，實(shí)現(xiàn)模型的自動(dòng)創(chuàng)建、自動(dòng)分析和自動(dòng)結(jié)果輸出。本文以操作實(shí)例的方式，介紹了 SAP2000 API 的入門(mén)編程方法，編程語(yǔ)言既有 C#，也有 VB，并且在最后涉及了一點(diǎn) MATLIB 的腳本。開(kāi)發(fā)平臺(tái)既有專(zhuān)業(yè)的 Visual Studio 2008 和 MATLIB，也有非常普及的 Excel、Word 和 AutoCAD。希望廣大 SAP2000 的使用者能通過(guò)本文輕松地掌握 API 開(kāi)發(fā)的入門(mén)知

4、識(shí)。一、 一、從外部程序調(diào)用 從外部程序調(diào)用 SAP2000 SAP2000 SAP2000 SAP2000在 SAP2000 12 的安裝目錄下， 有一個(gè) SAP2000_API_Documentation.chm 文件， 這個(gè)文件就是 API 文檔。它包含入門(mén)指南、函數(shù)參考手冊(cè)、樣例代碼等。需要特別注意的是，這個(gè)文檔有的地方并沒(méi)有及時(shí)更新，實(shí)際的函數(shù)接口可能跟文檔里寫(xiě)得不一樣。因此，樣例代碼有可能在編譯時(shí)會(huì)出錯(cuò)，需要做一些更改才能正

5、常運(yùn)行。本小節(jié)描述如何能運(yùn)行“Example 3 (Visual C# 2005)”樣例代碼。環(huán)境為 SAP2000 V12.0.2 +Visual Studio 2008。1、打開(kāi) 打開(kāi) VS2008 VS2008，新建項(xiàng)目，選 ，新建項(xiàng)目，選 C#, C#, Windows Windows 窗體應(yīng)用程序，名稱(chēng)為 窗體應(yīng)用程序，名稱(chēng)為 Example3 Example3，如圖 ，如圖 1.1 1.1 所示 所示：北 京 金 土 木 軟

6、 件 技 術(shù) 有 限 公 司Beijing Civil King Software Technology Co., Ltd.網(wǎng)址：www.bjcks.com www.archicad.net.cn 電話(huà)：010-88383866 傳真：010-88381056E-mail:info@bjcks.com (一般問(wèn)題); support@bjcks.com (技術(shù)支持); sales@bjcks.com (試用、購(gòu)買(mǎi)、升級(jí))ac@bjck.

7、com(ArchiCAD 一般問(wèn)題); acsupport@bjcks.com (ArchiCAD 技術(shù)支持)地址：北京首體南路 9 號(hào)主語(yǔ)國(guó)際 2 號(hào)樓 中國(guó)建筑標(biāo)準(zhǔn)設(shè)計(jì)研究院 郵編：10004833、添加按鈕 添加按鈕在解決方案中雙擊“form1.cs“， 在對(duì)話(huà)框中放置一個(gè)按鈕， 將該按鈕的 name 改為“buttonTest“, 將其 Text改為“測(cè)試”，如圖 1.5。圖 1.5 圖 1.64、為按鈕添加代碼 為按鈕添加代碼

8、(1)、為按鈕添加 Click 響應(yīng)函數(shù)。選中“測(cè)試”按鈕，在屬性欄的 Click 行輸入按鈕的響應(yīng)函數(shù)名稱(chēng)。如圖 1.6。(2)、在函數(shù) buttonTest_Click 中添加代碼。我們將 API 文檔的“Example 3 (Visual C# 2005)“中的代碼粘貼到這里，存盤(pán)、編譯。VS2008 會(huì)報(bào) 17 個(gè)錯(cuò)誤，都是“找不到類(lèi)型或命名空間名稱(chēng)“SAP2000””。原因是引用了 SAP2000 API 后，VS2008 自

9、動(dòng)給出的命名空間是“Sap2000”，而樣例代碼中的是“SAP2000”，大小寫(xiě)不同。5、修改錯(cuò)誤 修改錯(cuò)誤(1)、將“SAP2000”全部替換為“Sap2000”。(2)、其它錯(cuò)誤：錯(cuò)誤 錯(cuò)誤 1：代 碼：ret = SapModel.View.RefreshView(0, ref temp_bool);函數(shù)原型：int RefreshView(int Window, bool Zoom);第 2 個(gè)參數(shù)前不應(yīng)有 ref，刪除之，變?yōu)?/p>

10、：ret = SapModel.View.RefreshView(0, temp_bool);錯(cuò)誤 錯(cuò)誤 2：代 碼：ret = SapModel.LoadPatterns.Add(“1“, Sap2000.eLoadPatternType.LTYPE_OTHER, 1, ref temp_bool);函數(shù)原型：Int Add(string Name, eLoadPatternType MyType, double SelfWTMult