Autodesk.Revit.DB.ElementQuickFilter技术文档

Autodesk.Revit.DB.ElementQuickFilter 是一个 Revit API 类，它允许用户对 Revit 模型中的元素进行快速过滤和选择，从而方便用户快速选择所需的元素并进行操作。

构造函数

Autodesk.Revit.DB.ElementQuickFilter 包含以下构造函数：

• ElementQuickFilter(IEnumerable<ElementId> ids)：通过传入一个 IEnumerable<ElementId> 对象来创建一个新的 ElementQuickFilter，用于选择具有给定 ID 的元素。
• ElementQuickFilter(ElementFilter filter)：通过传入一个 ElementFilter 来创建一个新的 ElementQuickFilter，用于选择符合给定过滤器的元素。
• ElementQuickFilter(ElementFilter filter, IEnumerable<ElementId> excludedIds)：通过传入一个 ElementFilter 和一个 IEnumerable<ElementId> 对象来创建一个新的 ElementQuickFilter，用于选择符合给定过滤器但不包含给定 ID 的元素。

方法

以下是 Autodesk.Revit.DB.ElementQuickFilter 类提供的主要方法：

• OfCategoryId(BuiltInCategory categoryId)：返回一个新的 ElementQuickFilter，用于选择具有指定 BuiltInCategory 的元素。
• OfClass(Type type)：返回一个新的 ElementQuickFilter，用于选择指定类型的元素。
• Intersects(BoundingBoxXYZ box)：返回一个新的 ElementQuickFilter，用于选择与给定边界框相交的元素。
• WhereElementIsNotElementType()：返回一个新的 ElementQuickFilter，用于选择不是 ElementType 的元素。
• WhereElementIsElementType()：返回一个新的 ElementQuickFilter，用于选择是 ElementType 的元素。

应用示例

以下是使用 Autodesk.Revit.DB.ElementQuickFilter 进行选择的示例：

FilteredElementCollector collector = new FilteredElementCollector(doc);

ElementQuickFilter quickFilter = new ElementQuickFilter(BuiltInCategory.OST_Walls);

ICollection<Element> elements = collector.WherePasses(quickFilter).ToElements();

foreach (Element element in elements)
{
    // Do something with the selected elements
}

在以上示例中，我们使用 ElementQuickFilter 和 FilteredElementCollector 来选择具有指定** BuiltInCategory** 的所有模型墙。最后我们使用 ToElements() 方法将已过滤的元素从 FilteredElementCollector 转换为 ICollection<Element> ，并遍历选择的元素进行操作。

总结

Autodesk.Revit.DB.ElementQuickFilter 是一个强大的 Revit API 类，它提供了多种方式来快速选择所需的 Revit 元素，方便用户对模型进行操作。在根据类型或分类等属性筛选所需元素时，用户可以尝试使用 ElementQuickFilter。