這個章節會針對第一個外掛進行以下動作說明…
- Visual Studio (以下文章簡稱為VS) 專案建置與環境建立
- Visual C# 程式撰寫-FirstPlugin
- Add-In Manager使用
那事不宜遲,接下來就進入到我們Revit API開發的主軸吧!
Visual Studio 專案建置與環境建立
以下用圖文進行步驟教學,開啟VS先建立新的專案
使用C#、Windows、程式庫進行篩選,特別留意需選擇類別庫(.NET Framework)
取專案名稱,這裡使用的名稱為FirstPlugin,如果不是用這個名稱建立專案的話,稍後提供的程式碼記得要修改成你自己取的專案名稱。
加入參考
到要開發的Revit版本下(路徑:C:\Program Files\Autodesk\Revit 20xx),找到RevitAPI.dll與RevitAPIUI.dll這兩個檔案,加入參考。
- RevitAPI.dll:用於訪問Revit的應用程序、檔案、元素與參數。
- RevitAPIUI.dll:用於Revit使用者界面的操作和自定義界面。
將加入參考的RevitAPI、RevitAPIUI,屬性內複製到本機的參數選擇為False。
VS環境建置完成,開始寫程式嘍~ 底下有提供程式碼,可以直接整個複製貼上,留意如果專案名稱不同的,記得要修改為自己的專案名稱。
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Autodesk.Revit.UI;
using Autodesk.Revit.DB;
using Autodesk.Revit.Attributes;
using Autodesk.Revit.ApplicationServices;
namespace FirstPlugin
{
[Transaction(TransactionMode.Manual)]
public class Class1 : IExternalCommand
{
public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
{
UIApplication uiapp = commandData.Application;
UIDocument uidoc = uiapp.ActiveUIDocument;
Application app = uiapp.Application;
Document doc = uidoc.Document;
// Revit視窗顯示
TaskDialog.Show("Revit", "My First Plugin!");
return Result.Succeeded;
}
}
}
最後到VS的建置中重建方案(或建置方案),輸出顯示為成功即可,記得VS輸出dll的路徑位置。
接著,來看看我們第一個Revit API的成果吧!
請先確認已安裝Add-In Manager後,開啟Revit後,依序點選增益集 –> 外部工具 –> Add-In Manager (Manual Mode)
將剛剛VS輸出的dll檔載入至Revit中。
滑鼠左鍵點選兩下要執行的Class,則成功跳出我們的第一支Revit API成果嘍~