Revit二次开发，新手接入IExternalCommand、IExternalApplication，如何使用它们！

1.首先安装好Revit，至于版本是哪个关系不大。具体怎么安装，就不啰嗦了。安装完成后，桌面会有类似这样的图标：

上图是Revit2020和2019的图标，我自己的电脑是安装了两个版本的Revit。

2.找到安装目录下的两个dll文件，你可以把它copy出来，或者直接在C#工程项目中引用它：

3.新建一个C#新项目，我们以.net standard类库进行创建，然后编写一个类实现IExternalCommand接口

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

namespace UseIExternalCommand
{
    /// <summary>
    /// 演示类
    /// </summary>
    /// <creator>marc</creator>
    [Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Manual)]
    [Autodesk.Revit.Attributes.Regeneration(Autodesk.Revit.Attributes.RegenerationOption.Manual)]
    [Autodesk.Revit.Attributes.Journaling(Autodesk.Revit.Attributes.JournalingMode.NoCommandData)]
    public class Helloworld : IExternalCommand
    {
        /// <summary>
        /// 执行指令
        /// </summary>
        /// <param name="commandData"></param>
        /// <param name="message"></param>
        /// <param name="elements"></param>
        /// <returns></returns>
        public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
        {
            using (Transaction tran = new Transaction(commandData.Application.ActiveUIDocument.Document, Guid.NewGuid().ToString()))
            {
                tran.Start();

                TaskDialog.Show("提示", "工程名：" + commandData.Application.ActiveUIDocument.Document.ProjectInformation.Name);

                tran.Commit();
            }

            return Result.Succeeded;
        }
    }
}

4.编译后，将生成bin目录，我们把bin目录的路径copy到下图中：

选择外部工具下的Add-In Manager(Manual Mode)，如果你没有外部工具，那么你可以先找一下其它文章，先让Revit把这个插件装上。至于为什么会选择第一项Add-In Manager(Manual Mode)，这个是在代码中定义的：

5.好，下面将bin目录的地址copy进去 ：

点击“Load"按钮，然后选择bin目录下的编译好的项目dll文件。然后截入得到下面的效果：

6.选中刚刚载入的helloworld，进行点击"Run"的按钮，运行它：

7.如此便可完成Revit的IExternalCommand扩展入门。

 

---

 

除了IExternalCommand外，还有一个相应的叫IExternalApplication，二者的区别在于：

IExternalCommand：是用来执行具体的命令任务的，是执行者。如客户拿着一个菜单跟你说要来份炒粉，那么炒粉这个事情，就你来做。

IExternalApplication：是界面相关，主要用途是显示菜单。如客户拿着一个菜单跟你说要来份炒粉，那么菜单上有什么可以选的，那么这个菜单就是用IExternalApplication来做的。他不做具体的炒粉动作，只负责告诉客户，我有炒粉这道菜，你可以选择。

如果你实现了IExternalApplication，那么就可以类似上图红圈一样，在面板上任意加上你起的名字的菜单 。当点击这个菜单 的时候 ，会自动执行IExternalCommand这个动作。

IExternalApplication是与IExternalCommand关联的，你指定一个菜单的时候，必须告诉Revit点击这个菜单的时候 ，要启动哪个动作（IExternalCommand）。

8.IExternalApplication接口，他的使用时机是在Revit启动时进行初始化加载，关闭Revit的时候进行资源卸载。

namespace Autodesk.Revit.UI
{
    public interface IExternalApplication
    {
        Result OnShutdown(UIControlledApplication application);
        Result OnStartup(UIControlledApplication application);
    }
}

OnShutdown：在Revit这个软件关闭时被调用。

OnStartup：在Revit这个软件打开并初始化时被调用，软件打开后，不论你再新建几个Revit工程项目，都不会再第2次执行此方法。

9.介绍.addin文件。

上述操作是在外部工具中加载的。正常一个插件开发出来后，使用者，即我们的用户，他们是不会去用“外部工具”的，所以，我们需要配置一份执行指令以及菜单的.addin文件，具体这个文件的内容，读者可以参考其它文章。

<?xml version="1.0" encoding="utf-8"?>
<RevitAddIns>
	<AddIn Type="Command">
		<Assembly>UseIExternalCommand.dll</Assembly>
		<ClientId>ac97eb33-31cb-434e-a496-d1c5dd079681</ClientId>
		<FullClassName>UseIExternalCommand.Helloworld</FullClassName>
		<Text>你好世界</Text>
		<Description>Revit二次开发入门。</Description>
		<VisibilityMode>AlwaysVisible</VisibilityMode>
		<VendorId>ADSK</VendorId>
		<VendorDescription>Autodesk, www.autodesk.com</VendorDescription>
	</AddIn>
	<AddIn Type="Application">
		<Name>菜单</Name>
		<Assembly>UseIExternalCommand.dll</Assembly>
		<AddInId>9db84df0-b5b6-4ffb-ad16-a5c607f5624a</AddInId>
		<FullClassName>UseIExternalCommand.Menu</FullClassName>
		<VendorId>ADSK</VendorId>
	</AddIn>
</RevitAddIns>

10.如上面所示，一个带有执行指令IExternalCommand和菜单功能IExternalApplication的.addin文件就是这样，此时，重新打开Revit软件，将出现如下效果

菜单叫什么名字，是我们在IExternalApplication文件中定义的，具体代码，请参看源码即可。

至于点击“世界”这个菜单按钮，为什么会执行我们的IExternalCommand指令？也是在IExternalApplication中写好的，所以他才触发执行这个指令。

 

源码下载

下载地址：https://download.csdn.net/download/mazhiyuan1981/12875400