Revit API

【Revit API】05-Revit API UI創建 & AddInManager製作addin檔

by LuSir 2021-11-10

2021-11-10

此章節要教學的是，如何將寫好的外掛製作成按鈕，讓人可輕鬆執行，這裡會學習到的是以下…

Visual C# 程式撰寫Revit的UI外掛-FirstButton
使用Add-In Manager製作addin檔

這裡先提供稍後要製作按鈕的圖示，請先另存圖片下列綠色圖示，放置到你要讀取圖片的位置，下方提供的程式碼我是將它放在專案內。

Visual Studio 新增項目進行UI程式撰寫

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

通常 Visual C# 項目 會預設為類別，如果太多選項找不到，可以先選擇左方的程式碼，再選擇類別。接著將底下的Class取名，在此我取的Class名稱為FirstButton，如果你不是用這名稱的話，稍後提供的程式碼記得更改為你取的Class名稱。

VS環境建置完成，開始寫程式嘍~ 底下有提供程式碼，可以直接整個複製貼上，留意如果專案名稱不同的，記得要修改為自己的專案名稱，另一是輸出的dll檔與圖片路徑也記得要修改。

using Autodesk.Revit.UI;
using System;
using System.Windows.Media.Imaging;

namespace FirstPlugin
{
    public class FirstButton : IExternalApplication
    {
        public Result OnStartup(UIControlledApplication app)
        {
            // 要執行的dll與按鈕圖片檔案路徑
            string firstBtnDll = @"C:\Prj\Revit\FirstPlugin\bin\Debug\FirstPlugin.dll";
            string picPath = @"C:\Prj\Revit\FirstPlugin\FirstButton.png";

            // 創建一個新的工具列
            string tabName = "Revit API";
            app.CreateRibbonTab(tabName);
            // 添加面板
            RibbonPanel firstBtnPanel = app.CreateRibbonPanel(tabName, "First Button");
            // FirstBtn按鈕創建
            PushButton firstBtn = firstBtnPanel.AddItem(new PushButtonData("First_Button", "FirstPlugin", firstBtnDll, "FirstPlugin.Class1")) as PushButton;
            // 給按鈕添加圖片
            Uri firstBtnImage = new Uri(picPath);
            BitmapImage firstBtnLargeImage = new BitmapImage(firstBtnImage);
            firstBtn.LargeImage = firstBtnLargeImage;

            return Result.Succeeded;
        }
        public Result OnShutdown(UIControlledApplication app)
        {
            return Result.Succeeded;
        }
    }
}

最後到VS的建置中重建方案(或建置方案)，輸出顯示為成功即可，記得VS輸出dll的路徑位置。