Revit API 开发 (3): 一个使用过滤器(filter)的例子

*如何创建一个Revit AddIn 项目参考：Revit API 开发 (1): Hello World

下面这个例子是找到文档当中所有的门(Door)。

逻辑主线：

1. Door在Revit里面的element类型是FamilyInstance。

2. Door在Revit里面的category类型是OST_Doors。

3. 想要过滤特定类型的element需要ElementClassFilter。

4. 想要过滤特定类型的category需要ElementCategoryFilter。

5. 想要让两种类型的filter同时起作用需要LogicalAndFilter。

6. 找到文档(Document)里的element需要FilteredElementCollector，可以将其认为是文档中element的管理器。

7. 将filter传递给FilteredElementCollector即可得到所有能够通过filter的element。

public ICollection<Element> CreateDoorFilter(Autodesk.Revit.DB.Document document)
{
// 找到当前项目中所有的 family instances，并且它们的 category 是 door。
// 创建 ElementClassFilter 过滤器用以获得所有的 FamilyInstance。
ElementClassFilter familyInstanceFilter = new ElementClassFilter(typeof(FamilyInstance));

// 创建 ElementCategoryFilter 过滤器用以获得所有的 OST_Doors。
ElementCategoryFilter doorsCategoryfilter = new ElementCategoryFilter(BuiltInCategory.OST_Doors);

// 创建 logic And filter 将上面的两个过滤器合并。
LogicalAndFilter doorInstancesFilter = new LogicalAndFilter(familyInstanceFilter, doorsCategoryfilter);

// 将上面的过滤器应用到当前活动的 document。
FilteredElementCollector collector = new FilteredElementCollector(document);
IList<Element> doors = collector.WherePasses(doorInstancesFilter).ToElements();

return doors;
}