Autodesk.Revit.DB.FamilyInstanceFilter技术文档

概述

Autodesk.Revit.DB.FamilyInstanceFilter是Revit API中的一个过滤器类，用于过滤文档中的族实例对象。通过该类可以实现精细化的对象选择和操作。不同于ElementFilter基类，FamilyInstanceFilter可以选择面板、门、窗、家具等基于族类型创建的对象实例。

构造方法

Autodesk.Revit.DB.FamilyInstanceFilter类包含以下构造方法用于创建对象实例：

FamilyInstanceFilter(ElementId typeId)

该构造方法创建一个用于过滤指定族类型元素实例的FamilyInstanceFilter对象。参数typeId为族类型的唯一标识符(ElementId类型)。

FamilyInstanceFilter(List<ElementId> typeIds)

该构造方法创建一个用于过滤指定族类型列表元素实例的FamilyInstanceFilter对象。参数typeIds为族类型的唯一标识符列表(List<ElementId>类型)。

FamilyInstanceFilter(BuiltInCategory category)

该构造方法创建一个用于过滤指定内置类别(category)的FamilyInstanceFilter对象。内置类别指的是Revit中预定义的类别，如Windows、Doors、Furniture等。

FamilyInstanceFilter(List<BuiltInCategory> categories)

该构造方法创建一个用于过滤指定内置类别列表(categories)的FamilyInstanceFilter对象。

属性

Autodesk.Revit.DB.FamilyInstanceFilter类包含以下属性用于获取和设置对象属性：

ElementType

该属性返回FamilyInstanceFilter对象对应的族类型(Element)。

Categories

该属性返回FamilyInstanceFilter对象对应的内置类别列表(List<BuiltInCategory>)。

使用示例

以下示例展示了如何使用FamilyInstanceFilter过滤族实例对象。

// 获取当前文档
Document doc = commandData.Application.ActiveUIDocument.Document;

// 过滤窗户实例
FamilyInstanceFilter windowFilter = new FamilyInstanceFilter(BuiltInCategory.OST_Windows);

// 获取符合条件的窗户对象
List<Element> windows = new FilteredElementCollector(doc).WherePasses(windowFilter).ToList();

// 遍历并修改窗户类型
foreach(FamilyInstance window in windows)
{
    // 获取窗户族类型
    FamilySymbol symbol = doc.GetElement(window.GetTypeId()) as FamilySymbol;

    // 修改窗户族类型参数
    Parameter heightParam = symbol.get_Parameter(BuiltInParameter.WINDOW_HEIGHT);
    heightParam.Set(1200);
}

总结

Autodesk.Revit.DB.FamilyInstanceFilter是一个用于过滤Revit文档中基于族类型创建的实例对象的过滤器类。通过该类可以实现符合条件的对象的查找和修改。熟练掌握该类的使用可以提高Revit程序开发的效率。