Autodesk.Revit.DB.MassInstanceUtils

Autodesk.Revit.DB.MassInstanceUtils是Revit API中的一个类，用于与Revit族实例进行交互。实例是Revit族的具体实现，可以看作是对家具、设备等模型的实例化。

方法列表

下面是Autodesk.Revit.DB.MassInstanceUtils中可用的方法的简要列表：

• static IList<ElementId> CreateInstances(Document document, IList<ElementId> massElementIds)

  • 创建与选择的草图或组件同形的族实例。
  • document: Revit文档。
  • massElementIds: 要创建族实例的草图或组件的可枚举集合。
  • 返回一个值，该值表示新创建的族实例的元素ID。

• static IList<ElementId> CreateInstances(Document document, IList<ElementId> massElementIds, XYZ location)

  • 创建与选择的草图或组件同形的族实例，并定位到指定的位置。
  • document: Revit文档。
  • massElementIds: 要创建族实例的草图或组件的可枚举集合。
  • location: 定位族实例的位置。
  • 返回一个值，该值表示新创建的族实例的元素ID。

• static IList<ElementId> CreateInstances(Document document, IList<ElementId> massElementIds, IList<XYZ> locations)

  • 创建与选择的草图或组件同形的族实例，并定位到指定的位置。
  • document: Revit文档。
  • massElementIds: 要创建族实例的草图或组件的可枚举集合。
  • locations: 定位族实例的位置的可枚举集合。
  • 返回一个值，该值表示新创建的族实例的元素ID。

• static ElementId FindBlockFamilyInstance(MassInstance massInstance)

  • 查找给定草图或组件的族实例。
  • massInstance: 要查找的草图或组件的族实例。
  • 返回一个值，该值表示找到的族实例的元素ID。

• static IList<ElementId> FindBlockFamilyInstances(Document document, IList<ElementId> massElementIds)

  • 查找给定草图或组件的族实例。
  • document: Revit文档。
  • massElementIds: 需要查找给定草图或组件的族实例的可枚举集合。
  • 返回一个值，该值表示找到的族实例的元素ID。

示例

下面是一个使用Autodesk.Revit.DB.MassInstanceUtils创建族实例的示例：

// 打开一个Revit文档
Document doc = commandData.Application.ActiveUIDocument.Document;

// 选择创建草图或组件的元素
IList<ElementId> selectedElementIds = commandData.Application.ActiveUIDocument.Selection.GetElementIds();

// 从草图或组件创建族实例
IList<ElementId> newFamilyInstanceIds = MassInstanceUtils.CreateInstances(doc, selectedElementIds);

// 打印新创建的族实例的元素ID
foreach (ElementId newFamInstId in newFamilyInstanceIds)
{
    TaskDialog.Show("New Family Instance Created", newFamInstId.ToString());
}