瞭解預鑄施工圖指令的 API
預鑄「施工圖」指令會根據預鑄規劃中指定的類型特定設定,為預鑄元素建立圖面。對一個元素使用多個施工圖很常見,例如,對模板使用一個,對鋼筋使用一個。對施工圖加上標籤和標註的需求不同,也是一個因素。
預鑄 API 的每個部分都是在單一的 dll 中實施,API 的使用者除了參考這個單一 dll 之外,不需要參考預鑄的任何內容。預鑄本身不會以任何方式依賴預鑄 API 中的任何內容,甚至不需要 API dll 本身存在。
開始建立施工圖。當 API 呼叫施工圖建立時,可以提供「預鑄規劃」中所使用的相同設定。未對 API 指定的設定則會使用「預鑄規劃」中的設定。為了達到這個目的,建立方法需要一個 IShopDrawingOptions 介面的例證。呼叫者可以在任何類別上實施此介面,並讓介面指示它要定義哪些選項,以及不定義哪些選項。API 不需要存取「預鑄規劃」。如果某個設定不是由 API 呼叫者定義,則內部程式碼會讀取規劃。「預鑄規劃」只能供使用者透過使用者介面工具存取。
在 Revit 預鑄中,建立施工圖的類別是特別針對每種類型的元素。例如,有一個「Hollow Core Shop Drawing Creator」和一個「Solid Wall Shop Drawing Creator」。任何一種類別都是從一個共同的基準類別繼承。API 使用一個 Factory 類別和一個公用介面 (由定義公開 API 可以看見之類別部分的那些類別實施),來公開類別。
施工圖建立的事件。施工圖建立程序的步驟包括建立、製作詳圖,以及移動視圖和視埠。製作視圖詳圖則包括對視圖加上標籤和標註。每個步驟都有關聯的預處理事件和後處理事件,事件處理常式可以取消預處理事件。處理常式可以自行執行工作,或者完全不執行工作 (如果想這麼做)。
事件處理常式登錄後,預鑄 API 就會針對公用 API 看不見的內部事件登錄自己本身。然後它會轉送給已登錄的協力廠商事件處理常式,保護自己的子交易中的每個事件處理常式。
現在,事件處理常式參數已定義為介面,有效地將預鑄 API 與內部事物分開,以後就可以更輕鬆地變更內部程式碼,而不會影響預鑄 API。