API开发指南AutodeskRevit

　　《API开发指南 Autodesk Revit》由江苏省水利勘测设计研究院有限公司数字工程部工程师们在Revit API开发实战过程中参照Revit API在线英文帮助文献翻译编写，系统介绍开发人员如何应用RevitAPI接口进行Revit的二次开发。
　　《API开发指南 Autodesk Revit》以Revit2014版软件为平台，介绍RevitAPI的基础知识、开发工程和相关资源。书中配以大量的实例代码、图片和表格，方便读者更好地理解相关内容。参照《API开发指南 Autodesk Revit》RevitAPI知识，读者可以搭建二次开发环境，开发Revit插件实现Revit数据的读取、创建、修改、导入导出等；也可以通过API和.NET技术来创建用户交互界面，提供更好的用户体验；通过扩展Revit本身尚不具备的功能，使得Revit和其他软件平台进行交互，实现数据验证、检查和操作自动化，极大地提高数据利用率和设计效率。
　　《API开发指南 Autodesk Revit》适用于RevitAPI开发人员和相关高等院校师生，既可作为RevitAPI初学者的入门指南，也可供具备一定API编程经验的开发人员参考。

序
前言
第1章 引言
1．1 欢迎使用Revit平台API
1．1．1 Revit平台API简介
1．1．2 Revit平台API能做什么
1．1．3 必要条件
1．1．4 安装
1．1．5 受支持的编程语言
1．1．6 使用手册
1．1．7 文档协定
1．1．8 本版本的新特性
1．2 入门
1．2．1 演练
1．2．2 演练：Hello World
1．2．3 演练：添加Hello World功能区面板
1．2．4 演练：检索所选图元
1．2．5 演练：检索过滤图元
1．3 插件集成
1．3．1 概述
1．3．2 外部命令
1．3．3 外部应用程序
1．3．4 注册插件
1．3．5 本地化
1．3．6 属性
1．3．7 Revit异常
1．3．8 功能区面板和控件
1．3．9 Revit式任务对话框
1．3．10 数据库级外部应用程序
1．4 应用程序和文件
1．4．1 应用程序功能
1．4．2 文件功能
1．4．3 文档及文件管理
1．4．4 设置
1．4．5 单位
1．5 图元概要
1．5．1 图元分类
1．5．2 其他分类
1．5．3 图元检索
1．5．4 通用属性

第2章 Revit图元基本交互
2．1 过滤
2．1．1 创建图元过滤集
2．1．2 应用过滤器
2．1．3 获取过滤图元或图元ID
2．1．4 LINQ查询
2．1．5 边界框过滤器
2．1．6 图元相交过滤器
2．2 选集
2．2．1 更改选集
2．2．2 用户选集
2．2．3 过滤的用户选集
2．3 参数
2．3．1 演练：获取所选图元参数
2．3．2 定义
2．3．3 内建参数
2．3．4 存储类型
2．3．5 AsValueString()和 SetValueString()
2．3．6 参数关系
2．3．7 给图元添加参数
2．4 集合
2．4．1 接口
2．4．2 集合和迭代器
2．5 编辑图元
2．5．1 移动图元
2．5．2 复制图元
2．5．3 旋转图元
2．5．4 对齐图元
2．5．5 镜像图元
……
第3章 Revit几何图元
第4章 规程特有功能
第5章 进阶专题
附录

　　Autodesk Revit作为目前国内外应用广泛的BIM软件，除了自身功能强大之外，同时提供丰富的应用程序编程接口API（Application Programming Interface）。用户可以通过API来集成其他应用程序或者使用API来二次开发自己的应用程序操纵和访问Revit，把琐碎的建模工作自动化，自动检查Revit文件中的错误，借助API把其他软件的功能集成或链接到Revit中来，执行各种分析，在一个平台上完成用户的需求。
　　本书目录和标题采用中英文对照的方式，主要是为了保证叙述的准确性和唯一性。代码部分沿用IT行业习惯全部采用英文，对于一些组合词，无法翻译成中文的英文（如类名、函数名等）也沿用英文。另外，部分代码段的标题，为了便于阅读和对应查找也保留了英文。
　　本书所述主要以Revit2014为主体，少量提及之前的版本，2014之后版本的相关技术请参考相应的更新文献。本书技术内容操作性要求比较高，由于时间和精力所限，只对其中我们感兴趣和工作过程中涉及的代码进行了上机调试和运行。
　　本书适用于熟悉Revit应用的API开发技术人员和土木类院校师生，既可作为RevitAPI初学者的入门指南，也可作为具备一定API编程经验的开发人员的参考手册。
　　本书涵盖Revit建筑、结构、水暖电等方面的API开发内容，共分为6章。
　　第1章引言部分为全书的总览，介绍了RevitAPI基本功能和必要的基础知识，包含一些基础演练及代码，应用程序和文件，Revit图元基本分类、检索及属性等。
　　第2章Revit图元基本交互部分为全书的基础，介绍了图元的过滤、选集、参数、集合、图元的编辑以及各种视图等。
　　第3章Revit几何图元部分为图元进阶专题，介绍了房屋建筑相关的几何图元，族实例和族文件，概念设计，基准和信息图元，注释图元，几何类，二维、三维草图类及模型曲线，材料信息及管理等。
　　第4章规程特有功能部分为产品特有API，分别介绍了Architecture中的房间相关功能；Structure中的结构模型、分析模型、荷载，分析应用程序链接，分析节点图元连接；MEP中的暖通空调和管道，数据访问，包括专有图元、族创建，机械、电气设置及布管系统配置等。
　　第5章进阶专题部分为二次开发所必需的重点章节，包括共享参数，事务、事件，外部事件及可停靠对话窗格，动态模型更新，点云、分析、工作共享、导出等。
　　附录部分包括常用术语解释，常见问题解答，如何用Visual Basic.NET创建应用程序以及API用户界面指南。
　　本书编委会成员多为从事Revit API开发和测试的工程师。全书由宦国胜主笔并最终统稿，沈国华、贾健负责全书的校对等工作。其中，沈国华、贾健参与了第1章编写，吝江峰参与了第2章编写，左威龙参与了第3章编写，张超参与了第4章编写，王海俊参与了第5章编写，张耘、徐鹏、陈蕾蕾、洪项华参与了附录部分编写。