RevitAPI之FilteredElementCollector的基本应用
2018-01-13 21:04
232 查看
FilteredElementCollector即是收集器。它用来迭代以及过滤元素,它有三种构造方式,见表:
注意:初次创建该对象的时候,是没有应用任何的过滤器的,如果这时试图从该对象中迭代或者获取元素列表,会有异常抛出。
FilteredElementCollector提供了一系列的方法,允许用户设置査询和过滤感兴趣的元素集,以下是这几种方法的应用介绍:
1)通用方法WherePasses(),在收集器中应用单一的ElementFilter。该方法可以在结果中重复使用来增加不同的过滤器(filter)。
2)快捷方法,不需要传初始化过滤器对象的易于使用的方法,相当于常用过滤器filter 的快捷键。比如OfClass(),OfCategoryId(),OwnedByView()。
3)并集、交集等运算方法,比如UnionWith()和IntersectWith()。
这些方法返回收集器本身,并允许不同的过滤器链式调用。
FilteredElementCollector的应用实例:
向收集器设置完必须的的过滤器之后,就可以获取符合条件的元素了,可以使用以下几种获取:
1)获取元素ID或者元素本身的迭代器。
2)获取符合过滤器条件的元素ID或者元素本身的集合。
3)获取符合过滤器条件的第一个元素ID或者元素本身。当只需要唯一一个符合条件的元素时,这种方式很有用,因为不用再去遍历所有符合条件的元素了。
1) foreach语法支持
FilteredElementCollector支持foreach语法:
2) LINQ支持
FilteredElementCollector类对元素实现IEnumerable接口,因此,可以对这个类使用 LINQ査洵语句和操作。
LINQ实例:
=========【更多高级应用请关注公众号】========
==================================
构造函数 | 描述 |
FilteredElementCollector(Document document) | 迭代会从文档里所有的元素进行。 |
FilteredElementCollector(Document document, ICollection<ElementId> elcmentlds) | 迭代会在一个文档和ElementId集合中进行 |
FilteredElementCollector( Document document, Elementld viewld) | 传入一个文挡和一个视图,迭代会在视图中所见的元素中进行 |
FilteredElementCollector提供了一系列的方法,允许用户设置査询和过滤感兴趣的元素集,以下是这几种方法的应用介绍:
1)通用方法WherePasses(),在收集器中应用单一的ElementFilter。该方法可以在结果中重复使用来增加不同的过滤器(filter)。
2)快捷方法,不需要传初始化过滤器对象的易于使用的方法,相当于常用过滤器filter 的快捷键。比如OfClass(),OfCategoryId(),OwnedByView()。
3)并集、交集等运算方法,比如UnionWith()和IntersectWith()。
这些方法返回收集器本身,并允许不同的过滤器链式调用。
FilteredElementCollector的应用实例:
FilteredElementCollector collection = new FilteredElementCollector(RevitDoc); ElementFilter filter = new ElementCategoryFilter(BuiltInCategory.OST_StackedWalls); collection.OfClass(typeof (Wall) ).WherePasses(filter); ICollection< Elementld> foundIds = collection.ToElementIds();
向收集器设置完必须的的过滤器之后,就可以获取符合条件的元素了,可以使用以下几种获取:
1)获取元素ID或者元素本身的迭代器。
2)获取符合过滤器条件的元素ID或者元素本身的集合。
3)获取符合过滤器条件的第一个元素ID或者元素本身。当只需要唯一一个符合条件的元素时,这种方式很有用,因为不用再去遍历所有符合条件的元素了。
1) foreach语法支持
FilteredElementCollector支持foreach语法:
FilteredElementCollector collector = new FilteredElementCollector(m_doc); // 查询并遍历文档中所有的Level collector.WherePasses(new ElementCategoryFilter(BuiltInCategory.OST_Levels)).WhereElementIsNotElementType(); foreach(Level level in collector) { TaskDialog.Show("Level Name", level.Name); }
2) LINQ支持
FilteredElementCollector类对元素实现IEnumerable接口,因此,可以对这个类使用 LINQ査洵语句和操作。
LINQ实例:
FilteredElementCollector collector = new FilteredElementCollector(m_doc); // 首先使用一个内建的过滤器来减少后面使用LINQ查询的元素数量 collector.WherePasses(new ElementCategoryFilter(BuiltInCategory.OST_Levels)); // LINQ查询:找到名字为"Level 1"的标高 var levelElements = from element in collector bd6c where element.Name == "Level 1" select element; List<Autodesk.Revit.DB.Element> levels = levelElements.ToList<Autodesk.Revit.DB.Element>(); ElementId level1Id = levels[0].Id;
=========【更多高级应用请关注公众号】========
==================================
相关文章推荐
- OpenCV API应用手册(2)- 基本概念
- Apache Flink应用开发之API基本概念(更新中。。。)
- Java基本的API中,String,StringBuffer,Math,Wapper class的基本应用
- HTML5之canvas基本API介绍及应用 1
- Java使用新浪微博API开发微博应用的基本方法
- JavaScript中的基本API整理及应用
- RevitAPI之深入了解组(Group)和应用组
- HTML5之canvas基本API介绍及应用 1
- Objective-C中对象API的基本应用
- Objective-C中基本数据烦类型与对象数据类型相互转换的方法(OC中NSString的常用API的基础应用3)
- 网络应用的Socket API编程的基本调用流程
- Java基本的API中,String,StringBuffer,Math,Wapper class的基本应用
- 12.Java泛型的原理,基本和高级应用
- iosUIImage图片反响旋转(内存消耗超大基本应用不到项目中,有大神能解决求告知)
- 百度地图BMap API的应用实例
- 数据分析与数据挖掘在常规工作中的应用——基本统计量描述
- MySQL中函数、游标、事件、视图基本应用举例(代码)
- 使用IntelliJ IDEA(androidstudio前身)开发android移动应用前的基本设置,提高开发效率
- 使用 UDDI V3 API 构建安全的 UDDI 应用(
- 使用 UDDI V3 API 构建安全的 UDDI 应用