【Revit API】04-Revit API-First Plugin & AddInManager使用

by LuSir

這個章節會針對第一個外掛進行以下動作說明…

  • 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.dllRevitAPIUI.dll這兩個檔案,加入參考。

  • RevitAPI.dll:用於訪問Revit的應用程序、檔案、元素與參數。
  • RevitAPIUI.dll:用於Revit使用者界面的操作和自定義界面。

將加入參考的RevitAPIRevitAPIUI屬性內複製到本機的參數選擇為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成果嘍~

2 comments

【Revit API】05-Revit API UI創建 & AddInManager製作addin檔 – 假許起手式 2021-11-10 - 16:22

[…] 使用上一章節的專案新增項目 […]

Reply
【Revit API】03-Revit API-AddInManager安裝 – 假許起手式 2022-01-22 - 08:19

[…] Manager來運作(點選這裡看最末段落說明),另一是透過 Add-In Manager […]

Reply

Leave a Comment