Revit二次开发小白学习笔记5——要素对象Element

1.概念说明

要素>>族>>族类型>>族实例

1.1 元素的认识：Element(Family、ElementType、Instance)

• 族Family：Family
• 族类型ElementType：FamilySymbol、WallType、FloorType
• 族实例Instance：FamilyInstance

1.2 族>>族类型>>族实例

• 族是Family，基本族类型是FamilySymbol，基本族实例是FamilyInstance，都继承于Element
• 族可分为载入族和不可载入族：
  载入族：FamilySymbol
  不可载入族：WallType、FloorType等
• 实例也可分为内置类型的实例，如墙、楼板、梁等不是FamilyInstance
• 关系：一个族可以有多个族类型，一个族类型可以有多个族实例
• 族实例Instance：FamilyInstance

1.3 元素实例的获取

• 通过ElementId获取：document.GetElement(id) as FamilyInstance
• 通过过滤器获取
• 通过uiDoc.Selection.PickObject或者PipeObjects获取

2.获取要素

//通过ID获取要素
Wall wall = document.GetElement(new ElementId(201052)) as Wall;
TaskDialog.Show("获取要素1",wall.Name);


//过滤器获取要素：FilteredElementCollector elements1 = new FilteredElementCollector(document);//,new ElementId(201528)


//通过Selection.PickObject获取要素
Reference reference =  uIDocument.Selection.PickObject(Autodesk.Revit.UI.Selection.ObjectType.Element);
Element element = document.GetElement(reference);
TaskDialog.Show("获取要素3",element.Name);

3.可载入族通过族实例获取族类型和族

//获取族实例
FamilyInstance doorInstance = document.GetElement(new ElementId(201205)) as FamilyInstance;
//获取族类型
FamilySymbol doorSymbol = doorInstance.Symbol;
//获取族
Family doorFamily = doorSymbol.Family;

4.通过族获取族类型的集合

//获取族
Family doorFamily = doorSymbol.Family;
//创建要素Id集合，通过族获取要素Id
ISet<ElementId> ids = doorFamily.GetFamilySymbolIds();
//遍历族类型集合里面的每一个要素Id，根据Id获取要素，将要素转为族类型
foreach (ElementId elementId in ids)
{
    //根据Id获取要素，将要素转为族类型
    FamilySymbol familySymbol = document.GetElement(elementId) as FamilySymbol; 
}