建立巨集

在 Revit 中，所有應用程式層級巨集都會使用 Application 關鍵字在 C#、VB.NET、Ruby 和 Python 中定址應用程式物件。 . 這包含所有應用程式範圍內的資料和設定。

在 Revit 特有文件層級巨集中，C#、VB.NET、Ruby 和 Python 中的 Document 關鍵字會傳回 API Document 物件。如果您必須從文件層級巨集存取 Application 物件，請使用：

Document.Application

註: 如果應用程式或目前文件已包含巨集，則必須在「巨集安全性」設定中啟用巨集。請參閱〈巨集安全性〉。

建立巨集概述

1. 在巨集管理員中，選取「應用程式」頁籤 (若為應用程式層級巨集) 或「專案」頁籤 (若為文件層級巨集) 作為放置巨集的位置。
2. 在「巨集管理員」對話方塊的「建立」區段中，按一下「巨集」。

   將開啟「建立新巨集」對話方塊。

3. 輸入以下資訊：
   • 在「巨集名稱」欄位中輸入名稱。
   • 從「巨集位置」清單中選取一個父系模組。父系模組的語言將決定巨集的語言。
   • 此外，還可以在「描述」欄位中加入巨集的簡短說明。
   
4. 按一下「確定」。

   新巨集會放置在巨集管理員內的父系模組中。

   

   啟動 Revit 巨集 IDE 應用程式來撰寫巨集。它會以特定程式設計語言顯示巨集的開始樣板。

   例如，在一個應用程式級巨集的 C# 樣板中，Revit 巨集 IDE 已：

   • 包含必要的 using 指示。
   • 已識別模組名稱空間 (上圖中的 MacroAppCS)。
   • 已啟動 ThisApplication 類別定義。
   • 已啟動 Module_Startup() 和 Module_Shutdown() 的方法。
   • 已啟動您的新巨集方法 (上圖中的 MyFirstMacrosApp)，讓您有機會在大括弧之間加入實作程式碼。

   此外，請注意 Revit 巨集 IDE「專案瀏覽器」會向您展示上下文。

   
5. 現在可以在 IDE 的主視窗中輸入原始碼。請參閱〈巨集原始碼範例〉。
6. 按一下「檔案」「儲存 <巨集名稱>」，然後關閉 Revit 巨集 IDE。
7. 為模組中任何需要的其他巨集重複步驟 1 到 6。
   註: 請記住，您必須在 Revit 巨集 IDE 中成功建立並儲存模組專案，它們才會顯示於巨集管理員的分類清單中。請參閱〈在 Revit 巨集 IDE 中建置巨集〉。

   可選工具

   • 按一下「描述」以檢視所選模組或巨集的完整描述。如果巨集管理員的「描述」欄截斷，則此功能非常有用。
   • 請參閱〈修改及移除模組和巨集〉。