Hello World

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

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成果嘍~

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