Revit二次開發-創建族實例

族實例是通過族類型創建的，而創建族實例是Revit二次開發尤其重要的，因此小伙伴們要熟練掌握族實例的創建方法。

族實例重要的方法

1 FamilyInstance.Host

此方法獲取族實例的宿主；

2 FamilyInstance.rotate()

此方法來旋轉族實例；

3 FamilyInstance.FilpFacing()

此方法可以翻轉門窗的朝向；

4 FamilyInstance.Hand()

此方法翻轉開門方向。

5 FamilyInstance.GetSubComponentIds()

  Component.SuperComponent()

分別獲取構件的子構件與父構件。

族實例的創建方法

創建族實例的方法名為CreateFamilyInstance,存在于Autodesk.Revit.Creation.Document以及他們的父類中，他們的對象可以從Autodesk.Revit.DB.Document.Create獲得。

案例講解

本文結合之前所學的知識，首先利用公制常規模型做一個名稱為底座板的族，并添加實例參數角度（這里需要注意添加實例參數還是類型參數需要視實際情況而定）；族模型如下：

底座板族

添加的族參數

然后利用二次開發，創建族實例，并獲取族參數，修改其角度參數。（這里需要注意程序運行前需要將底座板族載入到項目）

程序關鍵代碼及注釋如下：

  注：代碼看不清可將圖片放大

運行結果如下：

左為改變參數前的底座板

  右為改變參數后的底座板  

整個步驟為：

1. 利用公制常規模型創建名稱為底座板的族，并添加主要參數，如角度參數設為40度。
2. 通過RevitAPI二次開發，找到類型為底座板的族，調用創建族實例的方法，創建族實例。
3. 獲取族實例的角度參數，修改其角度參數。
4. 運行Revit，首先載入底座板族，運行程序。

注意事項：

1. 在創建族模型時，添加的角度參數為實例參數，而不是類型參數，這樣可以創建族實例后在修改實例的角度參數。如果是類型參數需要先獲取類型參數進行修改，在創建族實例。
2. 在二次開發中，長度單位為英尺，角度用弧度代替，需要進行換算。
3. 運行程序前，需要先將族模型載入到項目中。