02.Revit2016二次开发（基础篇）——快速入门

就个人刚开始学习接触的经验来看，Revit二次开发开始需要必备以下几个东西：

一、Revit SDK

首先得先把Revit2016安装好，这里就不介绍如何安装了；然后在安装包中还需要安装Revit SDK；这里面包括了一些别人写好了的代码样例，还包括了为开发者参考API的一个的手册，我的建议是找到这个文件夹并建立快捷方式放在桌面上：

建立快捷方式到桌面

我喜欢在敲代码的时候在手册中查询，这样提高了效率；

二、接口定义文件RevitAPI.DLL，RevitAPIUI.DLL

首先打开Visual Studio创建一个类库：

创建C#类库

先添加引用RevitAPI.DLL，RevitAPIUI.DLL，文件的目录在如图所示的文件夹中：

添加引用

添加成功：

添加完成

类似的，还需要添加System.Windows.Form；因为我们所做的需要调用系统的消息框；

在程序的开头，我们需要添加命名空间：

添加 namespace

下面就可以开始写代码了：

namespace HelloRevit
{
    [Transaction(TransactionMode.Automatic)]
    [Regeneration(RegenerationOption.Manual)]
    public class Hello :IExternalCommand
    {
        public Result Execute(ExternalCommandData commandData,   /传入参数/
        ref string message, ElementSet elements                  /传出参数/
       )
        {
            MessageBox.Show("Hello World");
            return Result.Succeeded;
        }
    }
}

分析一下代码：

我们定义的类继承自IExternalCommand；IExternalCommand这个基类从名字来看是用来接收外部指令的，这个类当中有方法Execute:

Execute function

Revit会自动找到Execute，并开始执行里面的代码，也就是说程序的入口在Execute这个地方开始（相当于C或C++中的main函数入口）；实际上，我们所做的就是重载这个方法；

• 【注释】传入参数：

* ExternCommandData: 由此获取应用程序对象和文档对象；

• 传出参数：
  • ref string: 传出提示字符串，提示用户存在的问题；
  • ElementSet: 传出一个对象集合，用户可查看其中的对象；

点击生成，编译之后生成的文件在这个目录下：

编译文件

把这个地址复制；
打开Revit2016，随便进入一个项目，点击“附加模块”->“外部工具”（关于外部工具的导入，这里就不在赘述了，网上有教程）：

外部工具AddInManager

选择Automatic Mode，并把复制的地址给添加进去：

复制地址

• 打开运行就OK了：

  
  
  

  运行结果

三、编程时可能需要参考的类图：

类图