Revit 2014 Platform API Developers Guidelines

Autodesk官方发布的《Revit 2014 Platform API Developers Guidelines》（以下简称《指南》）是一份针对Revit 2014平台应用程序接口（API）的开发者指南。对于有志于从事Revit二次开发的人员来说，这份指南是必读的入门读物。尽管它是英文版本的，但只要具备一定的英语基础，就能够阅读并理解其中的内容。 《指南》首先向开发者介绍Revit平台API，解释了通过Revit平台API能够做哪些事情，以及进行开发前需要满足的要求。接着，文档会引导开发者完成Revit API开发环境的安装，并列出了支持的编程语言。在此基础上，《指南》还提供了用户手册、文档约定、本版本新增内容、实例操作、新增应用以及入门教程等信息，帮助开发者快速掌握API的使用。 在《指南》的内容部分，首先对API进行了简介，包括一些基础概念，例如：什么是外部命令（External Commands）、如何注册外部应用（External Application）以及如何进行Add-In集成（Add-In Integration）。接着，文档详细介绍了Revit API中常用属性（Attributes）、异常处理（RevitExceptions）、以及用户界面元素，例如：Ribbon面板和控件（Ribbon Panels and Controls）、Revit样式任务对话框（Revit Style Task Dialogs）等。 指南中还涉及到应用程序和文档（Application and Document）的功能，包括应用功能（Application Functions）、文档功能（Document Functions）、文档与文件管理（Document and File Management）以及设置（Settings）和单位（Units）的操作。 对于Revit元素的基本交互，《指南》提供了一系列的过滤器操作方法，如创建过滤元素采集器（Create a Filtered Element Collector）、应用过滤器（Applying Filters）、获取过滤元素或元素ID（Getting filtered elements or element IDs），还有边界框过滤器（BoundingBox filters）、元素交叉过滤器（ElementIntersectionFilters）以及通过LINQ查询进行元素选择（LINQ Queries for Selection）的方法。 此外，《指南》还涉及了Revit几何元素的操作，比如移动（Moving）、复制（Copying）、旋转（Rotating）、对齐（Aligning）、镜像（Mirroring）、分组（Grouping）以及创建元素数组（Creating Arrays of Elements）和删除元素（Deleting Elements）等编辑元素的方法。 在视图（Views）和视图管理方面，《指南》介绍了关于视图的基本概念，包括不同类型的视图，例如：三维视图（View3D）、平面视图（ViewPlan）、绘制视图（ViewDrafting）、选择视图（ViewSelection）、图纸视图（ViewSheet）和视图明细表（ViewSchedule）。接着，它还具体指导如何创建明细表、如何操作视图明细表以及如何处理表视图和表数据（TableView and Table Data）。此外，还包含了视图过滤器（View Filters）、视图裁剪（View Cropping）、位移视图（Displaced Views）和用户视图（UIView）等内容。 Revit平台的几何元素部分是《指南》的核心内容之一，它详细介绍了墙体（Walls）、楼板、天花板和基础（Floors, Ceilings and Foundations）、屋顶（Roofs）、幕墙（Curtains）以及其他类型的元素，如开放式结构（Compound Structure）和开孔（Opening）。 整体来看，《指南》涉及了从安装到使用、从概念到实践的各个方面，是学习和应用Revit API不可或缺的参考资料。对于希望深入开发Revit插件的开发者而言，这份指南提供了全面的指导，涵盖了从基础概念到高级操作的各个环节，帮助他们顺利地将想法转化为功能强大的Revit插件。