Revit API 开发 (1): Hello World

* 参考Revit 官方 help 写的，设置为原创而不是翻译，是因为内容虽然大致相同，但是风格迥异。

Revit API 的二次开发的环境通常是C#或者VB，原因是Autodesk一直是和微软的脚步一致的。下面是以C#为例。

1.新建一个Class Library的project。

 

2. 增加引用，又击添加引用，然后找到你自己的Revit安装目录，把RevitAPI.dll和RevitAPIUI.dll添加进来，记住最后不要勾选把dll复制到本地的选项，否则就会浪费不少空间。

3. 添加如下代码：

 

using System;
using Autodesk.Revit.UI;
using Autodesk.Revit.DB;

namespace HelloWorld
{
   [Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)]
   public class Class1 : IExternalCommand
   {
      public Autodesk.Revit.UI.Result Execute(ExternalCommandData revit,
         ref string message, ElementSet elements)
      {
         TaskDialog.Show("Revit", "Hello World");
         return Autodesk.Revit.UI.Result.Succeeded;
      }
   }
}

我相信大家最初写程序都是通过照葫芦画瓢的方式来的，这里也一样。从上面我们可以看到Revit为API开发者提供了一套框架，而这套框架的入口就是接口IExternalCommnad的Execute函数。用户所要做的就是创建自己的一个新类，这里是Class1，实现接口的这个方法即可。

 

4.让Revit可以找到这个DLL。

 

        
                D:\Sample\HelloWorld\bin\Debug\HelloWorld.dll
                239BD853-36E4-461f-9171-C5ACEDA4E721
                HelloWorld.Class1
                HelloWorld 
                NAME
                Your Company Info 
        

这是一个后缀为.addin的文件，在XP里面我们把它存在C:\Documents and Settings\All Users\Application Data\Autodesk\Revit\Addins\2014\，在Vista和Win7则存在C:\ProgramData\Autodesk\Revit\Addins\2014\。

 

5.调试

在项目的Debug菜单下，把外部程序的位置设上。C:\Program Files\Autodesk\Revit Architecture 2014\Program\Revit.exe

你可以打开Revit，把程序attach上去，并且在程序上设置好断点。比如就设置在，

 

TaskDialog.Show("Revit", "Hello World");

进入Revit，打开Add-Ins面板，点击：

 

你就会发现，断点被执行到了。在程序中点击继续，即可看到：

 

至此，Revit API 开发的基本流程就走完了。