Revit二次开发5、外部事件（ExternalEvent）

[个人学习笔记整理，若有错误请各位同仁告知]

外部事件ExternalEvent简介

事件

事件是Revit界面或API执行过程中触发的特定的动作。通过注册事件，一个插件程序能在某个动作即将发生或刚发生后得到通知，然后根据这个动作采取行动。

外部事件

Revit API提供了外部事件框架，可以用于非模式对话框。它是特别针对民步处理所开放的事件接口。它和闲置事件（IdlingEvent）处理类似，但可以由用户自己触发。
我对它的理解是：它主要用在非模态对话框窗口上，用于方便用户自己触发相应的Excute进行自己想要的操作。有了它，我们不需要每次操作都去调整Revit菜单或按钮命令，只需要在对话框窗口和Revit主窗口交互操作即可重复完成操作。

实现步骤

要使用外部事件来实现非模态对话框可以通过以下面几步来实现：

• 继承并实现外部事件处理接口（IExternalEventHandler）
• 用静态方法ExternalEvent.Create（）来创建一个外部事件（ExternalEvent）
• 当非模态对话框中某个时候需要调用Revit方法时，调用ExternalEvent.Raise（）；
• Revit会在下个闲置时间到时来调用IExternalEventHandler.Execute（）方法进行我们想要进行的操作。

外部事件的实现

实现IExternalEventHandler接口

实现这个接口的实例会被注册到Revit中，当每次相应的外部事件触发时，该接口的Execute（）方法会被调用，我们写入在此Execute（）中的命令会被执行，完成我们预期的操作。
IExternalEventHandler中有两个需要实现的方法：Excute（）方法和GetName（）方法。
Excute（）用于执行相应操作。
GetName（）方法返回事件的名字。
外部事件接口的定义：

public interface IExternalEventHandler
{
   
   
	// 事件处理函数
	void Execute( UIApplication app );
	// 事件处理函数的名称
	string GetName();
}

实现接口实例（以类名“EventCommand”为例 ）：

public class EventCommand : IExternalEventHandler
{
   
   
    public void Execute(UIApplication app)
    {
   
   
        UIDocument uidoc = app.ActiveUIDocument;
        Document doc = uidoc.Document;
        List<ElementId> elems = uidoc.Selection.GetElementIds().ToList();
        using (Transaction tran = new Transaction(doc, "删除构件"))
        {
   
   
            tran.Start();
            doc.Delete(elems);